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About This Book 


This book describes the various components of the NetView™ Release 2 program! 
that can be used for network operation. 


Who Should Use This Book 


This book is intended for use by system console operators, network operators, and 
system programmers. Before using this book, you should be familiar with the 
basic functions presented in the NetView Operation Primer. Specific operator pro- 
cedures are defined by the individual installation to suit local requirements. 


How To Use This Book 


This book is divided into the following parts: 


Part 1. NetView describes the various components of NetView, explains how to 
access each component, and tells how to use the online help. It also gives 
information on how to use the command facility to control, record, and auto- 
mate your network and system operations. 


Part 2. Hardware Monitor tells how to use the hardware monitor to identify 
hardware or software-related problems in a network. 


Part 3. Session Monitor tells how to use the session monitor to identify 
session-related problems in a network. 


Part 4. Status Monitor tells how to use the status monitor to monitor the status 
of network components. 


Appendix A. List of Commands provides a quick reference with each command 
listed alphabetically. 


Appendix B. List of Panel Fields provides a quick reference with each panel 
field listed alphabetically by component. 


Appendix C. Virtual Route Status Conclusions provides reference information 
for the session monitor Virtual Route Status panel. 


Appendix D. National Receive Signal Levels provides reference information for 
the hardware monitor Modem and Line Status panel. 


Appendix E. Hardware Monitor With Information/Management provides infor- 
mation on sending hardware monitor event data to the 
Iinformation/Management system. 


Appendix F. PF Key Assignments provides quick reference information with PF 
keys listed for each component. 


Bibliography lists publications that have been referenced in this manual. 


Glossary introduces new terms that are unique to NetView and redefines some 
existing terms that carry new meanings in the NetView environment. 


1 NetView is a trademark of International Business Machines Corporation. 


About This Book Xiil 


A detailed table of contents is shown at the beginning of each part. 


Throughout this publication, the term MvS means MVS/370 and MVS/xA, and VM means 
VM/SP and VM/SP HPO, and VM/XA. 


XIV. NetView Operation 


What Is New in This Book 


The following changes have been made for this release: 


These commands and CLISTs were added to or changed in Chapter:3: 


— AUTOTASK 
— CHANGEFP 
— DEFAULTS 
— DISCONID 
— EXCMD 

— GENALERT 
— LINKDATA 
— LINKPD 

— LINKTEST 
— MVS 

— OVERRIDE 
— RELCONID 
— RUNCMD 

— SETCGLOB 
— STARTDOM 
— TRANSMSG 
— UPDCGLOB 


This command was added to Chapter 6: 
— PURGEDB 
These commands were added to Chapter 9: 


— PURGE 
— PURGEDB 


Where To Find More Information 


When using this book you may find other NetView publications helpful. Those pub- 
lications are described in the following list. 


NetView Administration Reference, SC30-3361 

NetView Command Lists, $C30-3423 

NetView Command Summary, SX27-3620 

NetView Customization, SC30-3462 

NetView Installation and Administration Guide, SC30-3476 
NetView Operation Primer, SC30-3363 

NetView Operation Scenarios, SC30-3376 

NetView Messages, SC30-3365 

NetView Hardware Problem Determination Reference, SC30-3366 
Network Program Products Samples, SC30-3352 

Learning about NetView, SK2T-0292. 


What Is New in This Book 


XV 


In addition, Figure 1-1 on page xi shows all of the books in the NetView Release 2 
library, arranged according to related tasks. For more information on related pub- 
lications, see “Bibliography” on page X-1. 
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Chapter 1. Getting Acquainted with NetView 


As networks grow in size and complexity, it becomes increasingly difficult to 
manage them without effective tools. The NetView™ program! allows you to 
control and monitor the systems in your network as well as the jobs, subsystems, 
and online users that run on these systems. It provides a comprehensive set of 
tools to allow you, the network operator, to perform network management. These 


tools help you to: 


e Control the network 


¢ Monitor the logical network 

e Monitor the physical network 

e Determine the status of network resources 

e Automate the control and monitoring of the network. 


NetView consists of the following components: 


Command facility 


Hardware monitor 


Session monitor 


Status monitor 


Help facility 


Browse facility 


Provides base service functions and automated oper- 
ations. Included are the operator interface and 
network/trace logging facilities. The command facility can 
also operate as a subsystem of Mvs. This facility is also 
called NCCF. 


Gives information about physical network resources. This 
includes failure information that shows probable cause 
and recommended actions. Information on the 4700 support 
facility (MVS and VSE) is also included. 4700 support facility 
is called TARA. The hardware monitor is also called NPDA. 


Gives information about the logical network resources. 
This includes session related information, such as 
response time measurement and the components that 
make up a session. This facility is also called NLDM. 


Displays the status of network resources in a hierarchical 
manner and allows you to browse the network log. This 
facility also automatically reactivates minor nodes (except 
applications and cross domain resources (CDRSCS)). The 
status monitor is also called STATMON. 


Displays online help information for the NetView compo- 
nents, panels, and commands. This facility includes a pro- 
cedure that help desk personnel can use to help with 
problem determination. An index is provided for quick ref- 
erence. 


Provides capability to browse the network log or a data 
member (MvSs) or file (vm). 


Figure 1-1 on page 1-2 shows the relationships among these components. 


1 NetView is a trademark of International Business Machines Corporation. 
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Tasks 


1-2 NetView Operation 


Operator 
terminal 


NetView Data bases 
that are updated by NetView: 


Network Log 

Command Facility Trace Log 
Hardware Monitor Data base 
Session Monitor Data base 
4700 Support Facility Data base 
External Log 


To Network 


Figure 1-1. NetView 


NetView operates as a VTAM application program. It can also operate as a sub- 
system of Mvs. It provides a network log to record information as necessary. You 
can move from one component to another with a single command. : 


NetView can perform more than one function at a time by allowing many functions 
to run independently. NetView controls these functions by defining units of work 
called tasks. The types of tasks are: 


OST Operator Station Task. There is one ost for each NetView operator. There 
are also automated Osts which perform unattended operations functions 
related to automation and require no operator. 


NNT NetView-NetView Task. There is one NNT for each NetView in another 
domain with which this NetView communicates. This task controls that 
communication. 


PPT Primary Program Operator Interface (Pol) Task. This task processes com- 
mands and CLIsTs that are not entered by an operator (for example, a timed 
event or a message-driven CLIST). 


DST Data Services Task. This task processes requests for CNM or VSAM data. 
This is the interface to network management data and VTAM. 


Command Types 
NetView processes four types of commands: 


e Regular commands 

e Immediate commands 

e Data services task commands 

e Both regular and immediate commands. 


Most commands and all CLISTs are regular commands. Regular commands can run 
concurrently with other regular commands. Regular commands can be interrupted 
by system routines or by immediate commands. 


Immediate commands, such as RESET, GO, CANCEL, and AUTOWRAP Can interrupt or 
preempt regular commands. As their name implies, they are run as soon as the 
command is entered. Only one immediate command runs ata time. Immediate 
commands can only be run in the command facility. | 


System Console Operation 


In order to use NetView, the system operator may first start NetView from the 
system console. Generally, this is done automatically when the operating system 
is initialized. 


lf you are the system operator, talk with your system programmer about the 
defined operating procedures for your installation before performing any of the 
tasks described in this section. In Mvs, NetView commands and CLISTs can be 
entered from system consoles by using the designator prefix character (% is the 
default). Note: If you are not the system operator, your operator identification 
probably will not let you perform the activities described in this section. 


Starting NetView 
On MVS: Both NetView and the NetView subsystem start as jobs in the system. In 
order to start NetView manually, you would enter: 


START NVname CNMPROC 
START SSname CNMPSSI 


where NVname is the name of the NetView procedure and SSname is the name of 
the NetView subsystem procedure. These names may vary in your installation. 
Your system programmer can give you these names. (See NetView /Installation 
and Administration Guide.) 


Under mvs, NetView can also be started automatically by using the COMMNDXx 
member of SYS1.PARMLIB. (See MVS/XA System Programming Library: Initialization 


and Tuning.) 


On VM: NetView is started with a NETSTRT EXEC by entering: 
NETSTRT 


or another ExEC name chosen by your system programmer. Ask your system pro- 
grammer for this name. 


Under vm, NetView can also be started using the following command, which is 
already in the NETSTRT EXEC: 
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NETVIEW START NETVIEW 


The NETVIEW START NETVIEW Command can be changed so that it attaches the pro- 
grammable operator-message exchange (PMx). The format for this command is: 


NETVIEW START PMX PARM userid 


where userid is the identification of the active vm/sP programmable operator. The 
CANCEL command detaches the main task and the Pmx, if active. 


Connecting an MVS Operator’s Console to NetView 


An MVS operator can issue NetView line-by-line commands and CLISTS from an Mvs 
operator’s console. An AUTOTASK command in NetView creates an unattended 
operator station task dedicated to running network commands from a specified mvs 
console and converting network messages into write-to-operators (wTos) for that 
console. The NetView CLISTs or commands must be immediately preceded by the 
NetView designator character (%), when they are entered at an Mvs operator's 
console. 


NetView messages are sent to the mvs console as wTOs from the NetView job or 
started task. 


Replying to NetView’s WTOR Message 
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While you are on the system console (or from VM, the virtual machine that is 
running NetView), you will see one of the following two messages which indicate 
that NetView is active: 


*xx DSI802A domainid REPLY WITH VALID NCCF SYSTEM OPERATOR COMMAND 
*xx DSI803A domainid REPLY INVALID. REPLY WITH VALID NCCF TERMINAL OPERATOR 
COMMAND 


The xx in the above messages is the reply number that you can use to enter any of 
the following commands: 


CLOSE 

CLOSE DUMP 
CLOSE IMMED 
CLOSE NORMAL 
MSG operid,text 
MSG LOG, text 
MSG SYSOP, text 
MSG ALL,text 
REPLY Pxx. text 
REPLY Lxx. text 


Command synonyms for CLOSE, MSG, and REPLY are not accepted when replying to 
NetView’s WTOR message. 


To send a message to an operator you would enter: 


¢ On MVS: 
REPLY xx,MSG operid,message 
¢ On VM: 


R xx MSG operid,message 


where xx is the reply number from the message DSI802A or DSI803A. The operid is 
the operator to whom you are sending the message. 


For another example, to stop NetView, you would enter: 


e On MVS: 
REPLY xx,CLOSE IMMED 


°e On VM: 
R xx CLOSE IMMED 


Another example would be to reply to a VTAM message. If the VTAM message 
P45 IST272A NO INITIAL TEST FOR AO8NV6 - REPLY ’U’ TO BYPASS - OR CANCEL 


appears on the NetView operator’s screen, you might enter: 


¢ On MVS: 
REPLY xx, REPLY P45 text 


e¢ On VM: 
R xx REPLY P45 text 


For detailed explanations of the CLOSE, MSG, and REPLY commands, see 
Chapter 3, “Command Facility Command Descriptions.” 


Stopping NetView 
The decision to stop NetView implies that you are shutting down a portion of the 
network or have transferred control of a portion of the network to another NetView. 
This can be done for routine maintenance or as an error recovery procedure. 


If necessary, uSe REPLY to isSue CLOSE IMMED, which immediately stops operator 
tasks, and then proceeds as CLOSE NORMAL. 


From the system operator’s console, you may use the system REPLY command to 
enter the CLOSE command. On MVS, you may issue CLOSE as a NetView subsystem 
command. For example, enter: 


¢ On MVS: 


% CLOSE 
or 
REPLY xx,CLOSE 


¢ On VM: 
R xx CLOSE 


where xx is the reply number. NetView will stop automatically when all operators 
and incoming cross-domain operators have logged off. 


Note: If you want to shut down NetView without waiting for all operators to logoff, 
you should use CLOSE IMMED rather than CLOSE. 
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Security 


Span of Control 
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For the most part, your system programmer sets up the authority and security 
measures. One such measure is called span of control. Span of control restricts 
an operator’s control to selected network resources. 


Another security measure that your system programmer can Set up is called scope 
of commands. Scope of commands restricts the use of commands and operands to 
a single operator or group of operators. 


If your system programmer set up a span of control for your operator ID, you can 
enter only the VTAM commands and the START and STOP RESOURCE Commands for 
resources that are within that span of control. The restriction ensures that you are 
controlling only specific resources. 


In a network, an operator’s span of control may cross other spans of control. (The 
network resource name is the basis of control and network routing.) When more 
than one operator has authority to control a given resource, this condition is called 
an overlapped span of control. Either operator can control the network resource. 
The result on that resource is the cumulative effect of the commands from the over- 
lapped operators, depending on the sequence in which VTAM received them. 


You may be defined as having global authority over all spans. This means that you 
have control over the whole network and that span of control does not apply. 
Use the commands below to check or change your span of control. 
e LIST (page 3-99) 
LIST operid 
displays the name of the profile that contains your span definitions. 
LIST PROFILE=profilename 
displays your profile to find out the names of the spans that you can control. 
LIST SPAN=spanname 
displays which resources are in the specified span. 
e START (page 3-156) 
adds a span list to your span of control. 
The START RESOURCE Command starts a resource within your span of control. 
° STOP (page 3-162) | 
takes a span list out of your span of control. 


The STOP RESOURCE Command stops a resource within your span of control. 


Scope of Commands 
Your system programmer sets up scope authority. The authority is filed for use by 
the system when commands are entered. 


For example, the system programmer may want to restrict the use of the CLOSE or 
STOP FORCE commands to a subset of operators. If you enter a command that is not 
within your scope of commands, you get an error message on your screen. Com- 
mands and operands not specifically restricted are available to all operators. If 
your profile does not contain scope limits, you are considered to have unlimited 
scope. All commands and operands are accepted. 


In mvs, your system programmer can restrict the use of operands on any command. 
Extending scope of commands to check accessibility to command parameters 
allows the system programmer to choose what keywords and values need to be 
restricted. See NetView Installation and Administration for more information. 


You can use the LIST SCOPE command (page 3-99) to find out which commands you 
are authorized to use. 


Note: 


The hardware monitor performs a scope check on certain commands to see if the 
user is allowed to issue the command. The hardware monitor does not check all 
commands. Only the following hardware monitor commands are subjected to 
SCOPE checking: 


¢ PRGATT 

¢ PURGE 

® PURGEDB 

® REPORTS 

® SRATIO 

© SRFILTER 

¢ SWRAP 

e the DEL option from the Alerts-Static, Alerts-History, or the Current Filter Status 
displays 


The individual command descriptions in Chapter 6 indicate whether or not scope 
checking is done on that command. (Also see NetView Administration Reference.) 


Terminal Operation 


Before you can begin to use NetView, you must have the logon panel displayed on 
your screen. Figure 1-2 contains an example. If, however, you do not have the 
logon panel, check with your system programmer to find out how to log on. To log 
on from the logon panel, enter: 


LOGON APPLID(applid) [LOGMODE (logmode) ] 


where applid is the name of the NetView application that you are logging on to and 
logmode specifies information about your terminal. Before you begin to use 
NetView as a NetView operator, you must have the logon panel displayed on your 
screen. 
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Figure 1-2. Example of Logon Panel 


Entering Logon Information 
Before logging on, you must have an operator profile defined. Check with your 
system programmer to see what has been defined for you. 


Here is what you enter into the fields of the logon panel (Figure 1-2): 


OPERATOR ID 
Specifies what your operator identification is. This could be your name or 
a word that your system programmer has assigned to you. 


PASSWORD 
Is a one- to eight-character string that is used to prevent other people from 
using your operator identification. To ensure that no one sees your pass- 
word as you enter it, text entered into the password field is not displayed. 
If you enter the password incorrectly you will not be able to see where the 
mistake was made, so if you make a mistake, retype all eight positions of 
the password field. 


PROFILE 
Describes what operator profile to use. This field is optional. The profile 
has information about your span of control, domains, scope of commands, 
operator classes, the name of the terminal you use for a hard-copy log, 
whether you are an authorized receiver or not, and the name of a CLIST 
(command list) that may run after you have logged on. If you do not enter 
a profile name, you will receive a default profile. Check with your system 
programmer for details about your profile. 
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HARD-COPY LOG 
The name of the printer that gives you a printed copy of what has hap- 
pened during your session. This field is optional. The printer you name 
will start when you log on. A default printer name may be in your profile. 
If you do not want to use a printer, enter No in this field. 


RUN INITIAL COMMAND 
Runs a predefined procedure (CLIST) when you log on. This CLIST is set up 
by your system programmer. The default is YES, indicating that you want to 
use the predefined procedure. If you enter No, you will not use the prede- 
fined procedure. 


Correcting Mistakes 
If you enter incorrect logon information, you can correct what you typed by doing 
one of the following: 


e Position the cursor to the field with the mistake. Press the ERASE EOF key and 
retype the correct information. 


e Press the CLEAR key to erase all your input and start over. 


e If you pressed the ERASE INPUT key, press the CLEAR key and start again. 


Successful Logon 
If you have logged on successfully, and if receiving the NetView main menu was 
specified as part of your initial logon CLIST, you will see the following panel: 


Figure 1-3. NetView Menu Panel 


From this panel, you can: 


e Enter any component 
e Display the PF key settings 
e Exit NetView. 


To do any of the above type the name of the command next to the cmp line. For 
example, to enter the command facility, enter the following command: 
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CMD==> NCCF 


You can return to the NetView Menu panel by entering the MAINMENU command (see 
page 3-109), by rolling (PF6) back to the panel, or by returning (PF3) to the panel. 


If NetView was installed with the DASD Conservation Option, you will see the fol- 
lowing panel: 


Figure 1-4. NetView Menu Panel when Installed with the DASD Conservation Option 


Screen Layout 
NetView presents data in two formats. In line mode, data is presented one line ata 
time. In full-screen mode, data is presented a screen at atime. Generally, the 
hardware monitor, session monitor, and status monitor use full-screen meode, while 
the command facility uses line mode. 


Line Mode 


The line mode screen has four sections: 


¢ Session Identification Line - Section ¢ 
e Message Area - Section 
e Response Area - Section 
¢ Command Entry - Section 


Refer to Figure 1-5 on page 1-11 as you read about each section. 
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NCCF 


~ NCFO1 
NCFO1 


NCFO1 
NCFO1 
NCFO1 
NCFO1 
NCFO1 
NCFO1 


“-* viNdOi:OoO * 


NCFO1 


NCFO1, 


NETVIEW — NCFO1 OPER1 05/16/87 11:57:30 A 


DSI0201 OPERATOR OPER’ LOGGED ON FROM TERMINAL H11L42E USING 


_ PROFILE(PROFSEC ) ,HCL(¢ ) 
~ LOGONX- | | 


* You have CTL=GLOBAL and MSGRECVR=NO for your session. 
DSI0821 AUTOWRAP STARTED | oo | 

* Enter LOG/LOGOFF to terminate session. 

* Enter HELP, PFK1 OR PFK13 FOR HELP. 

DSI001] MESSAGE SENT TO OPER1 

M01 MSG FROM OPER1 : news update as of May 16th, 1987 
LIST KEY=PF1 


DSI607I1 KEY ----TYPE---- ---------- COMVAND- ~~------= 


DS16081 PF1 


IMMED/APPEND ?HELP 


DSI6091 END OF PF/PA KEY DISPLAY 


ee eliemadienasKene tenarikenssiecestbane tihassa] 


| DSI606I1 DISPLAY OF PF/PA KEY SETTINGS 
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Figure 1-5. Sample Panel 


Session Identification Line: Section... is the session identification line. It contains 
the domain identifier (NCFO7), the operator identifier (OPER7), and the date and 
time as follows: 


e mm/dd/yy is the date in the order of month, day, and year. 
e hh:mm:ss is the time in the order of hour, minutes, and seconds. 


At the end of this line are indicators about the rules the system is using as you 
enter commands: 


e Ais the AUTOWRAP indicator. This means that AUTOWRAP iS On. AUTOWRAP is 
explained later in “AUTOWRAP” on page 3-25. 


e H is the held-screen indicator. This means that the screen will not roll forward 
unless unlocked by the operator. Held messages are explained in “HOLD” on 
page 3-83. 


e P is the PAUSE status indicator. PAUSE is explained later in “CLIST Commands” 
on page 2-13. 


e W is the walt indicator. WAIT is explained later in “CLIST Commands” on 
page 2-13. 


Message Area: Section’ is the message area. This area displays the messages, 
commands, data, and responses that come from and go to this terminal. The size 
of this area depends on the size of the command area and your screen size. A 


message. The line above the broken line is the newest message. The line below 
the broken line is the oldest. Each new message replaces the existing broken line 
and a new broken line replaces the oldest message, giving the appearance that the 
broken line moves down the screen. 
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Most messages have the following format: 


type domid code msgno text 


where: 
type 
domid 
code 
msgno 


text 


@) 


Ni <|/s/<}/C/]o/o};z |m 


Figure 
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is the message type (see Figure 1-6) 

is the domain or application that the message came from. 

is a code as follows (see Figure 1-7 on page 1-13): 

is the message number that you can use to look up more information. 


is the text of the message. 


Message automated to drive CLIST or command 


Message or command generated during CLIST 
processing 


External message 

Message from an MSG command 

Unsolicited message from VTAM 

Message text provided by a user exit routine 
Message from installation-written code 

VTAM command from the system console 
Message satisfying CLIST WAIT 

VTAM message from the system console 
Message from the Data Services Task 
Cross-domain or immediate command message 
DSl-prefix message 

Command echo 

Solicited message from VTAM 


Message generated by a command other than a 
NewView command 


Operator action required 


DSI-prefix message headings for multiple-line 
message 


DSi-prefix messages following a heading © 


User-written full-line message 
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P The message came from the PPT. 


% The message is sent only to the authorized 
receiver of the messages. 


P% The message is to the authorized receiver and 
came from the PPT. 


The message is to a secondary receiver. 


+ The message has been copied and sent to this 
receiver. 


Figure 1-7. Message Codes 


Note: In some cases, the left portion of the message (type domid code) is dis- 
played on a line by itself as a title, and the right portion of the message (msgno 
text) is on the following line. 


Generally, messages disappear as the screen scrolls. The two exceptions are 
reply messages and held messages. 


Reply messages are messages to which you must reply before you can delete 
them from the screen. These messages will appear in high intensity on your 
screen with a Pnn or Lnn after the message number, where nn is a 2 digit number. 
Unsolicited reply messages received on the system console remain outstanding 
even after a reply is given. These messages must be deleted manually using the 
Mvs control (K) command. 


Held messages are messages that are defined by your system programmer to be 
held on the screen. This means they will not be removed from the screen until you 
specifically delete them. These messages appear in high intensity (or are other- 
wise highlighted) and are located at the top of the message area. If there are more 
messages being held than can be displayed on your type of terminal, then these 
are queued and only appear when existing ones are deleted. It is not apparent that 
messages are being queued. To delete a held message, move the cursor one posi- 
tion in on the left side of the message line. Enter any character in the space. If 
you type a character in the space and then decide not to delete the message, press 
the CLEAR key. | 


Response Area: Section — is the response area. It looks like this: 


2??? ind message 


where: 
22? identifies the start of the response area. 
ind is the lock or unlock indicator. If the indicator is blank, the screen is 


unlocked and messages can be displayed. If the indicator contains 
three asterisks (***), no messages can be displayed until one of the fol- 
lowing occurs: 


e You press CLEAR 
e You press ENTER with no data in the command area 
e You enter another command 


message is a message indicating the status of system processing. When you 
press any action key (ENTER, PF, PA, Or CLEAR), the response area is 
erased. 
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Full-Screen Mode 


Command Area: Section © is the command area. The system positions the 
cursor at the beginning of this area. This is where you type your commands. You 
can set the size of this area with the INPUT Command. 


The length of the command area is limited to 240 characters. To indicate the end 
of the command area, enter a blank followed by < < <. When you press any 
action key (ENTER, PF, PA, Or CLEAR), the command area is erased. 


If your system programmer defined a suppression character, you can use this char- 
acter to prevent all writing of an entered command, including output to your screen 
and the network log. : 


To suppress a command, enter the suppression character immediately before the 
command name with no intervening blanks. For example, if a question mark (7) is 
coded as a Suppression character and you enter: 


?LIST STATUS=TASKS 
Command suppression only works in command facility. 


The command LIST STATUS=TASKS does not appear on your terminal’s screen or on 
the network log. However you do get a listing of the tasks’ status. 


Your system programmer may also specify on the CMDMDL statement in DSICMD that 
a command will not be shown on your screen when you enter it. 


Ask your system programmer about suppression characters and command echo 
suppression. 


In full-screen mode, color and highlighting are used to identify problems or areas 
of possible concern. Wherever possible, the system makes a decision on the 
severity of a message or the contents of a status field. This decision is displayed 
using color or highlighting, depending on your screen type. 


Seven-Color Terminals: Most components permit the use of color. For terminals 
that can display seven colors, the following colors are used to show the system’s 
decision as to the importance of the information displayed: 


Green Good or normal condition. 

Yellow Marginal or warning condition. 

Red Bad or error condition. 

Four-Color Terminals: For terminals that can display four colors, the following 


colors are used to show the system's decision as to the importance of the informa- 
tion displayed: 


Blue Good, normal, marginal, or warning conditions. 
White Bad or error condition. 
Monochrome Terminals: For monochrome terminals, the following highlighting is 


used to show the system's decision as to the importance of the information dis- 
played: 


Normal Intensity Good, normal, marginal, or warning conditions. 


High Intensity Bad or error condition. 
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The Keyboard 


ENTER Key 


CLEAR Key 


ATTN key 


PF Keys 


The keyboard is your means of communicating with the system. You type in com- 
mands to ask the system to do work for you. You use the ENTER, CLEAR, ATTN, PA, Or 
PF keys in combination with information typed into the command area. 


After you have typed a command in the command area, you press the ENTER key to 
tell the system to do the requested work. The ENTER key also unlocks the message 
area on the screen. To unlock the screen without entering a command, press the 
ENTER key with no data in the command area. 


When you use the regular screen and press the CLEAR key, the screen is completely 
erased except for Held messages. The CLEAR key also unlocks the output area. 
Any output messages that still require responses are written in order at the top of 
your screen, starting with the oldest message. New messages will then be dis- 
played after these reply messages. 


If you are using an SNA terminal and press the ATTN key, any command processors 
or command lists that are running will be cancelled at the next breakpoint (if they 
have a breakpoint). This function is the same as entering the RESET NORMAL 
command. 


For the most part, PF key definitions are consistent across all components. The PF 
keys will not be defined unless you run PFKDEF CLIST. 


Note: Ask your lead operator if your default PF key settings are established. 


A description of the PFKDEF CLIST is in “PFKDEF” on page 3-129. The standard defi- 
nitions are as follows: 


PF1 HELP Displays help information. 


PF2 END Returns the system to the previous component that you 
were using. If there was no previous component, you are 
returned to the command facility. Any PF keys that you set 
while in the current component are discarded. 


PF3 RETURN Returns the system to a previous level. If the point where 
this panel was requested is another component, this key 
functions in the same way as the END key (PF2), except that 
any PF keys that were set by you during this session are 


saved. 
PF4 TOP Displays the first page of the series for a multipage panel. 
PF5 BOTTOM Displays the last page of the series for a multipage panel. 
PF6 ROLL Moves the name of the current component at the beginning 


of the sequence in which you go from one component to 
another, and re-enters the component at the end of the 
sequence, displaying the panel that was displayed when 
you last left that component. For example, if you enter 
NLDM, followed by HELP, followed by NPDA, the sequence 
remembered is: 
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NLDM - HELP - NPDA 


Pressing the ROLL PF key changes the remembered 
sequence to: 
NPDA - NLDM - HELP 


and displays the help panel that was displayed when you 
left the help facility. 


Pressing the ROLL PF key again changes the remembered 
sequence to: 


HELP - NPDA - NLDM 


and displays the panel that was displayed when you left 
the session monitor (NLDM). 


PF7 BACKWARD Displays the previous page of the series for a multipage 
panel. 

PF8 FORWARD Displays the next page of the series for a multipage panel. 

PF10 DISPFK Displays the current PF key settings. 

PF12 RETRIEVE Places the previously entered command in the command 


area within the current component. 


If your keyboard has 24 PF keys, keys 13 through 24 are set up exactly as PF keys 1 
through 12. Some of the components vary in their PF key usage. See 

Appendix F, “PF Key Assignments by Component” on page F-1 for the variations 
by component. 


Moving among Components 


You can get to the various NetView components in several ways: 
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From any component, you can enter another component name, for example, 
NPDA. The last panel viewed in hardware monitor (NPDA) appears. 


From any component, you can direct a command to another component. For 
NLDM, NPDA, and TARA (4700 support facility) commands, you prefix the command 
with the component name unless you are already in the component. For 
example, from the status monitor, you can enter: 


NPDA TOT ST 

to view the total statistics information in the hardware monitor (NPDA). 
If you are already in NPDA, you can enter: 

TOT ST 

From the session monitor, you can enter: 

MONIT START ALL 


without prefixing it with STATMON, as it is not one of the components named 
above. 


NetView allows you to have multiple components active at the same time. The 
ROLL function allows you to move among active components in a continuous 
loop. To access the ROLL function, press PF6. ROLL returns you to the last panel 
you viewed in an active component. 


Note: Ask your lead operator if your default PF key settings are established. 
You can find a discussion on PF keys in Appendix F, “PF Key Assignments by 
Component” on page F-1. 


Help Information 
NetView provides the following types of online help information: 


e Product overview—provides an overview for the network management capabili- 
ties of the system 


¢ Immediate help—provides an overview for the requested component 
¢ Command help—explains command and command list (CLIST) usage and syntax 


e Error code help—explains SNA sense codes, return codes, feedback codes, 
status codes, and recommended actions for error conditions 


e Help desk facility—guides help desk operators through problem resolutions 


e Index—provides access to help information by subject. 


While you are reviewing information using the help facility, you cannot be inter- 
rupted by messages from NetView. At any point in the help facility, you can issue a 
NetView command by entering the command in the AcTION field. You can then go 
directly to the component for which you entered the command. When you leave the 
component (PF6 or PF3), the system returns you to the point in the help facility that 
you were reviewing. 


DASD Conservation Option 
ex NetView Release 2 is available with an installation option designed for unat- 
tended distributed hosts. If this option is used, then no online help (except sense 
codes explanations) will be available on that host. Also, most hardware monitor 
commands will be unavailable. You must use the hardware monitor SDOMAIN 
command from a full NetView host to set the hardware monitor domain to the 
domain of the NetView host which has installed with the DASD Conservation Option 
prior to entering hardware monitor commands that are not allowed to be processed 
at the DASD Conservation Option NetView host. 
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Product Overview 
To enter the product overview, enter HELP NETVIEW. The system then displays the 
following panel: 


Figure 1-8. The NetView Help Main Menu 


You can now select any topic by entering the appropriate number in the ACTION 
field. For example, to get an overview of NetView, enter 1 next to the Action field. 
For example, 


Action===> 1 


As you finish reading each panel, press prs. When you are through with this 
selection, press PF3 to return to the main menu. At this point, you can select 
another topic or press PF2 to leave the help facility. 


Note: This command is not allowed if NetView is installed with the DASD Conserva- 
tion Option. 


Immediate Help 


To enter the immediate help facility, enter: 
HELP Component 


where component is the name of the NetView component for which you want help. 
For example, to display online help for the status monitor, enter: 


HELP STATMON 


The system displays a menu panel. After making your selection, press ENTER. As 
you finish reading each page of the panel, press prs. When you are through with 
this selection, press PF2 to return to the panel where you entered HELP STATMON. 


Note: This command is not allowed if NetView is installed with the DASD Conserva- 
tion Option. 


For more information on the HELP command, see “HELP” on page 3-79. 
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Command Help 


Error Code Help 


Sense Codes 


You can request online help for NetView commands in two ways. If you already 
know the name of the command (or CLIST) but are unsure of the syntax, type the 
command name in the command area and press PF1. If online information is avail- 
able, it is displayed. 


The second way is to request a list of commands by component. To do this, enter: 


HELP component COMMANDS 


where component is the name of the NetView component for which you are 
requesting help. For example, to display online help for the status monitor com- 
mands, enter: 

HELP STATMON COMMANDS 


The system displays a menu panel with all the commands available for the partic- 
ular component. After making your selection, press ENTER. When you finish 
reading the panel, press PF2 to return to the point where you requested help. 


Note: This command is not allowed if NetView is installed with the DASD Conserva- 
tion Option. 


For additional information on the HELP command, see “HELP” on page 3-79. 


Online information can help you understand the various messages that you may 
receive in NetView. Information is available for the following: 


e Sense codes 

® vTAM return and feedback codes 

® vTAM Status codes and status modifiers 
e Recommended action codes. 


lf you receive a message containing an SNA sense code concerning an error ona 
VTAM resource, you can get an explanation of the sense code by entering: 


The code is the sense code. For example, for an explanation of sense code 
x‘0806’, enter: 


SENSE 9806 


Note: The sense codes are the only error codes that are available online if 
NetView is installed with the DASD Conservation Option. 


For more information on this command, see page 9-39. 


VTAM Return and Feedback Codes 


If you receive a message containing a VTAM return code and feedback code, you 
can get an explanation of these codes by entering: 


Fs ge Vs dos afi gl le, £93 
Rg F pe A? yes ve gs ge TRL YS 
RLEE rincd, tanks 


The rtncd represents the VTAM return code and fdbk2 represents the associated 
feedback code. If you were not given a feedback code, enter nothing. 


For example, if you receive a message containing the following information: 
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you can get an explanation of this return code and feedback code by entering: 
RCFB 14,10 


Note: This command is not allowed if NetView is installed with the DASD Conserva- 
tion Option. 


For more information on this command, see page 3-134. 


VTAM Status Codes and Status Modifiers 
If you receive a message containing a VTAM status code and status modifier, you 
can get an explanation of these codes by entering: 


STATUS code 


The code represents the VTAM status code. 


For example, if a DISPLAY command shows: 
STATUS=ACTIV----¥ 

you can find out what ACTIV means by entering: 
STATUS ACTIV 


Note: This command is not allowed if NetView is installed with the DASD Conserva- 
tion Option. 


For more information on this command, see page 3-161. 


Recommended Action Codes 
| If you receive a recommended action code on a hardware monitor panel, you can 
get an explanation of this code by entering: 


& geo T SLR: 5 
ACTION cade 


The code represents the recommended action code. 


For example, if you receive a recommended action of D023, you can find out what it 
means by entering: 


mh Pe yyas gn #3 “$ 
a f x f a 2 es i Mg? Eas 
cr i ee a kee ae, 


3 


Note: This command is not allowed if NetView is installed with the DASD Conserva- 
tion Option. 


For more information on this command, see page 6-3. 


NetView Help Desk 


You can use the help desk to help determine what a user’s problem may be. This 
facility leads you through a series of panels to teach you techniques in problem 
determination. 


To enter the help desk, enter HELPDESK. The system then displays the following 
panel: 
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CNVHDESK | sO NETVIEW HELP DESK 


Select To get internation about 
1 A terminal not working 
2 A transeetion or an application not working 
3 Slow response time 
4. Problems identified through network monitoring 
e) system message cross-reference 


Type a number (1 through 5), then press ENTER. 
 -PF1 -=+> Reconmendations for cece and use of the help desk 
HELP NETVIEW ---> NetView Help Menu 
Act ion===> | fe 


PFi= Help PF2= End PF3= Return | 
PF6= Rol | PF7= Backward _ PF11= Entry Point 


Figure 1-9. Help Desk Panel 


You can now select any topic by entering the appropriate number in the ACTION 
field. For example, to learn techniques on determining the reason for slow 
response time, enter 3: 


"9 


Action= = = cs 
As you finish reading each panel, press PFs. When you are through with this 
selection, press PF3 to return to the main menu. Remember that at any point you 


can enter a NetView command. To leave the help desk facility, press PF2. 


Note: This command is not allowed if NetView is installed with the DASD Conserva- 
tion Option. 
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Chapter 2. Using Command Facility Commands 


The purpose of this chapter is to illustrate the capabilities of the command facility 
(NCCF) commands. The page number next to each command refers you to a 
description of the command syntax. 


Screen Control Commands 


Use the screen control commands to control the operation of the terminal. These 
commands should not be used under an automation task. See “AUTOTASK” on 
page 3-23). The commands are: 


INPUT (page 3-89) 

Sets the size of the command area of the screen. 

AUTOWRAP (page 3-25) 

Changes how and when the screen is scrolled. 

HOLD (page 3-83) 

Prevents the screen from unlocking until you are ready to receive messages. 
AGAIN (page 3-7) 

Sends the last command you entered back to the system for processing. 
RETRIEVE (page 3-142) 


Causes the last command you entered to be placed in the command area. You 
can then alter the command and press the ENTER key to send the command to 
the system for processing. 


Displaying the Status of Network Resources 


Use the network display commands to find out the status of various resources that 
make up that part of the network over which you have control. The display com- 
mands and CLISTS are: 


AINQ (page 3-8) 


Displays information from the alias translation tables about the names of 
logical units (LUs), classes of service (COSs), or logmode names that are the 
same in more than one network. 


APPLS (page 3-10) 

Displays the status of network application programs. 
APPLSACT (page 3-11) 

Displays the application programs that are active. 
APPLSPEN (page 3-12) 

Displays sessions that are waiting to become active. 
BFRUSE (page 3-27) 


Displays VTAM buffer usage information. 
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¢ CDRMS (page 3-44) 

Displays cross-domain resource manager (CDRM) major nodes in your domain. 
e CDRSCS (page 3-45) 

Displays cross-domain resource (CDRSCS) major nodes in your domain. 
¢ CLSTRS (page 3-51) 


Displays the status of all type 1 and type 2 physical units (or cluster controllers) 
and their respective major nodes. 


¢ DISG (page 3-58) 


Displays resource status and connectivity information for LUs, PUs, lines, NCPs, 
and major nodes. 


¢ DROUTE (page 3-65) 


Displays the status of explicit routes (ERS) and virtual routes (vRs) in your 
domain. 


e LINES (page 3-91) 
Displays the status of lines and channel links in your domain. 
e MAJNODES (page 3-110) 
Displays the status of all active major nodes in your domain. 
e NCPSTOR (page 3-121) 
Displays the contents of an NCP. 
e NODE (page 3-124) 
Displays information about a specific major or minor node. 
e PATHS (page 3-127) 
Displays dial-out path information for a switched Pu. 
e PENDING (page 3-128) 
Displays information about nodes in the domain that are pending activation. 
¢ STATIONS (page 3-160) 
Displays the status of all cross domain link stations within each node. 
e TERMS (page 3-170) 


Displays the status of all the LU device types in active major nodes. 


You can also enter the VTAM DISPLAY command from your terminal. For more infor- 
mation on this command, see the VTAM Operation manual. 


Controlling the Network 


Use the network commands to change the status of various resources that make up 
that part of the network over which you have control, to modify what your network 
has or does, and to reply to network messages. The commands are: 


e ACQ (page 3-3) 


Causes VTAM to take over control of a resource. 
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ACT (page 3-5) 
Activates a resource. 
AUPD (page 3-17) 


Alters the information in the alias translation table. You can add or delete 
logical unit, class of service, or logmode definitions, or replace existing defi- 
nitions with a new set. 


AUTOTR (page 3-24) 

Controls buffer tracing for cross-domain terminals. 
DRDS (page 3-64) 

Reconfigures an NCP. 

FTRACE (page 3-74) 


Starts a trace (io, buffer, transmission groups, lines, or VTAM) or changes 
current trace. 


INACT (page 3-85) 

Deactivates a resource. 

INACTF (page 3-86) 

Forces a resource to be inactivated. 
MVS (page 3-118) 


Allows you to send commands to the Mvs operating system of the domain you 
are in. 


NCPDUMP (page 3-119) 

Dumps an active NCP. 

NETWORK (page 3-122) 

Displays all networks defined to an NCP. 
NOSTAT (page 3-125) 

Stops the recording of tuning statistics. 
RECYCLE (page 3-135) 

Deactivates and then activates a network resource. 
REDIAL (page 3-136) 

Dials a switched line. 

REL (page 3-137) 

Releases a previously acquired NCP or PU. 
TNSTAT (page 3-173) 


Changes or restarts the recording of tuning statistics for VTAM. 
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You can also enter the following VTAM commands from your terminal: 


DISPLAY 
MODIFY 
VARY 


For more information on these commands, see the VTAM Operation manual. 


3710 Network Controller Commands 


Use the 3710 network controller commands (sometimes referred to as the Network 
Product Support commands) to do network management tasks for the iBM 3710 
Network Controller. The commands are: 


e CANCMD (page 3-39) 
Cancels outstanding 3710 commands. 
e DISPCMD (page 3-60) 
Displays a list of the current outstanding 3710 commands. 
e DISPCNFG (page 3-61) 
Displays a 3710 configuration or a single element of the configuration. 
e¢ DSISAPDR (page 3-67) 
Changes the service adapter password for the 3710. 
¢ LINESTAT (page 3-92) 
Controls a specific line. With this command you can: 


— Set the line speed to half or full 
— Seta line to a switched backup line 
— Start the secondary link. 


e LPDA (page 3-106) 
Changes or queries the LPDA status of a line or station attached to a node. 
e RUNDIAG (page 3-150) 


Performs online diagnostics in a 3710. The diagnostic tests that you can run 
are to test the: 


— Communication adapter 
— Cable 
— Service modem. 


e THRESH (page 3-171) 


Displays or changes the current threshold value for stations attached to the 
3710 and the NCP. 


586X Modem Commands 


Use the 586X modem commands to do network management tasks involving the 
IBM 586X family of modems. The commands are: 


e CANCMD (page 3-39) 


Cancels outstanding 586X commands except the MOMCNFG command. 
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e DISPCMD (page 3-60) 
Displays a list of the current outstanding 586X commands. 
e LPDA (page 3-106) 
Changes or queries the LPDA status of a line or station attached to a node. 
e MDMCNFG (page 3-111) 
Allows you to browse and update the 586X modem configuration. 
e MDMCNTL (page 3-114) 
Allows you to: 


— Change the transmission speed 

— Close or open a contact (built-in relay) 

— Detect the current of a sensor 

— Dial a station using the switched network backup line 

— Disconnect a station using the switched network backup line. 


¢ THRESH (page 3-171) 


Displays or changes the current threshold value for stations attached to the 
586X and the NcpP. 


Listing Operator-Related Resources 


Use the List command (page 3-99) to display information about operator-related 
resources, such as: 


e Network log 

e Trace log 

e NetView tasks 

¢ Operator identification 
e Profile 

e Terminal status. 


Message Control Commands 


You can use the message control commands to send and receive messages to 
other operators or to the network log. The commands are: 


e ASSIGN (page 3-13) 


Allows you to direct messages to other operators or to the network log. This 
function is also provided in the message automation table. 


e AUTOMSG (page 3-20) 


Activates the message automation function. It can also be used to display the 
status or deactivate all automation functions. 


e LIST MSG (page 3-99) 
Lists the operators that are authorized to receive messages. 
e MSG (page 3-117) 


Allows you to write and send a message to other operators or to the network 
log. 
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Network Log and Trace Log Commands 
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Use the network log, which includes NetView or VTAM commands, responses, and 
unsolicited messages, to record terminal activity. Each message contains the date 
and time it was sent and the name of the sender, destination, and message type 
from which it was sent. 


NetView maintains the network and trace logs on a VSAM file. The network log and 
trace log can be started automatically by the operator. When the primary file is 
filled with information, logging switches automatically to a secondary file, if one is 
defined. When the secondary file is filled, the recording may stop or switch back to 
the primary file. Ask your system programmer how this works on your system. 


You can use the following commands to control the network and trace logs: 
e LIST DSILOG (page 3-99) 
Displays the status of the network log. 
e LIST DSITRACE (page 3-99) 
Displays the status of the trace log. 
e START (page 3-156) 
Starts the network and trace logs. 
e STOP (page 3-162) 
Stops the network and trace logs. 
¢ SWITCH (page 3-167) 
Switches the network and trace log files. 


You can print the inactive network and trace log files in batch mode while the 
system is using the active file as the log. 


On an MVS system the printing is done using the JCL program DSIPRT. You may 
also be able to print the active log using DSIPRT. For information, ask your system 
programmer. 


On a VM system you can print the log in any one of the following ways: 


e Use the CMS EXEC DSIPRT. When using DSIPRT you must specify either PRIMARY or 
SECONDARY as a parameter, depending on which log you want to print. 


e Use the PRINTLOG CLIST. This CLIST is included in the sample NCCELST files. For 
more information, see your system programmer or the NetView Installation 
and Administration Guide. 


e Use the START TASK=DSIPRT Command from the system console. Before you do 
this, you must first send the following commands to the system to set up the 
required files: 


FILEDEF DSIINP DUMMY (LRECL 80 PERM 
FILEDEF DSILST PRINTER (LRECL 132 PERM 
DLBL DSILT fm DSN log (PERM VSAM) 


where fm is the VSAM minidisk access mode and /og is the file name defined by 
the system programmer. 


You can browse the contents of the network log by using the status monitor (see 
11-1) or the BROWSE command (page 3-33). 


Service Point Commands 


Use the service point commands to provide facilities for a network operator to com- 
municate with and control applications on a service point. The commands are: 


DISPCMD (page 3-60) 
Displays a list of the outstanding NPS commands. 
CANCMD (page 3-39) 


Allows you to cancel any outstanding network product support (NPS) commands 
except for CANCMD, DISPCMD, and MDMDNFG. 


LINKDATA (page 3-93) 


Requests that a service point application return device data for a given link or 
link segment. 


LINKPD (page 3-95) 


Requests that a service point application do problem determination on a given 
link or link segment. 


LINKTEST (page 3-97) 
Requests that a service point application test a given link or link segment. 
RUNCMD (page 3-149) 


Allows service point application commands to be sent to a service point and 
executed by a given service point application. 


Automation Commands 


Use the automation commands to do routine activities automatically. Commands 
may be started by a timer, either at a specific time or repetitively at intervals you 
specify. You do not have to be logged on when the commands are scheduled to 
run. Commands can also be started whenever certain messages are issued in the 
system or received on the network. The automation commands and CLISTS are: 


AT (page 3-15) 


Schedules a command to be run once at a specific time of day. For example, 
at 2:00 P.M.. 


AUTOMSG (page 3-20) 


Activates a message automation member of DSIPARM. The IF...THEN... automation 
statements will determine which conditions within messages should cause 
commands or CLISTs to be run. 


AUTOTASK (page 3-23) 
Starts a specified automated operator. 


DEFAULTS (page 3-53) 
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Sets system-wide defaults for logging and displaying messages, and deter- 
mines how the HOLD and BEEP actions are interpreted in the message auto- 
mation table. 


DELAY (page 3-54) 


Tells the system to wait for a specified amount of time and then, if a command 
is specified, send it to the system. 


EVERY (page 3-71) 


Schedules a command to be run during certain intervals of the day. For 
example, every 20 minutes. 


OVERRIDE (page 3-126) 


Sets message processing options to be used instead of those selected by the 
message automation table for a particular operator. 


PURGE (page 3-131) or DELAY2 (page 3-55) 
Stops a timer request scheduled by the AT or EVERY command. 
LIST TIMER (page 3-99) 


Displays the status of a timer request. 


DASD Conservation Option 


Certain command facility and help facility commands are not allowed when 
NetView is installed using the DASD Conservation Option. You should issue these 
commands from a host that was not installed with the DASD Conservation Option. 
The commands that are not allowed are: 
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ERST (page 3-69) 

Displays the meaning of the explicit route status code. 

HELP (page 3-79) 

Displays help information for the NetView components and commands. 
HELPDESK (page 3-81) 


Provides information to help you determine a user’s problem. Techniques for 
problem determination are explained. 


INDEX (page 3-87) 
Displays subjects that are discussed in the help panels. 
RCFB (page 3-134) 


Displays the information describing the specified return code and feedback 
code. Only VTAM return codes and feedback codes are handled by this CLisT. 


STATUS (page 3-161) 
Displays information on VTAM status codes and status modifiers. 
TUTOR (page 3-178) 


Displays the panels with filetype NCCFLST (VM). 


e VAST (page 3-181) 


Displays the meaning of the virtual route status. 


Automatic Command Entry 


Commands can be run at specific times or at time intervals by using the aT and 
EVERY commands. You can request that they be run either under your own operator 
station task or under the PpT. You can also cause commands to be run when a 
message is received by coding an IF-THEN automation statement and loading the 
member containing the statement using the AUTOMSG command. The IF part of the 
statement describes the message that should cause the commands to be run, and 
the THEN part of the statement describes what commands to run and where they are 
to run. You can route these commands to be run under the PPT or under any oper- 
ator station task that is logged on when the message occurs. An example is oper- 
ator tasks that are started by the AUTOTASK command. Command routing in the 
message automation statements can run the command under all the operator IDs in 
a list that you give, or only under the first operator ID that is actually logged on. 


Data Services Task Commands 


Use the data services task (DST) commands to control data services tasks such as 
the network and trace logs. The following operator commands are used to control 
the data services tasks: 


e LIST STATUS (page 3-99) 
Displays the status of data services tasks. 
e PURGE (page 3-131) 
Purges a data services task request. 
e START (page 3-156) 
Activates a data services task. 
e STOP (page 3-162) 
Forces a task to be ended. 
¢ SWITCH (page 3-167) 


Lets you use either the primary or secondary network and trace logs, or switch 
control of the DST tasks. Check with your system programmer. Your network 
and trace logs may switch automatically between the primary and secondary 
files, as needed. 


Operating System Commands 


In Mvs systems, system operator commands can be entered from NetView operator 
stations and CLISTS. MVS Commands or system command verbs can be used directly 
if CMDMDLS are defined. (See NetView Installation and Administration Guide.) 


¢ DISCONID (page 3-57) 


Displays Mvs console IDs used by NetView. 
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e MVS (page 3-118) 
Is used to enter an MVS system operator command from NetView. 
e RELCONID (page 3-138) 


Releases the mvs subsystem console Ip that was obtained in a previously 
issued MVS command. 


Communicating with Multiple NetView Programs 


Communicating with more than one NetView from your operator station is some- 
times referred to as a NetView-NetView task (NNT). The commands to do this are: 


e LIST STATUS (page 3-99) 


Displays the current configuration for a specified operator or the status of all 
cross-domain NetView sessions. 


e ROUTE (page 3-145) 

Sends commands to a NetView in another domain. 
e START (page 3-156) 

Starts a cross-domain session with another NetView. 
e STOP (page 3-162) 


Ends the cross-domain session with another NetView. 


Automatic Routing of Commands 
You can also automatically route VTAM commands to other domains. Your installa- 
tion can define resources as being controlled by another NetView (in another 
domain). When you enter a vTAM command for one of these resources, the system 
automatically sends the command to the right domain. Before entering the 
command, you must be logged on to the other domain using the START command 
and be defined as having the proper span authority in the other domain. For 
example, an operator in domain D1 could enter the following command for a 
resource in domain D2: 


DISPLAY NET, ID=LU2024A1 


D1 searches its table of resources for resource LU2024A1. Not finding that resource, 
the system searches the resource routing defaults (RRD) statements and finds that 
the resource is in domain D2. The command is sent to D2 and, if LU20241A is in the 
operator’s span of control in D2, information about the device is displayed to the 
operator in D1. 


In some situations, you must override the system’s understanding of which domain 
controls the resources. If a new VTAM takes over the resources, the operator 
entering commands must prefix the resource name with the name of the domain 
that now controls the resource. You use manual routing in this case to override 
automatic routing. 


When resources are controlled with span of control, you can use START RESOURCE 
and STOP RESOURCE commands to change the implicit routing for a resource. 
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Connecting to VTAM Applications 


You can connect to VTAM applications from NetView. This is sometimes referred to 
as the terminal access facility (TAF). You can use the VTAM applications in either 
full-screen session or operator-control session. VTAM applications that you can 
access are IMS/VS, CICS/VS, TSO, HCF, NPM, and other NetView sessions. While you 
are in VTAM applications, NetView processing continues. 


The commands that you would use to access VTAM applications from NetView are: 
¢ BGNSESS (page 3-29) BOSESS (page 3-32) and BFSESS (page 3-28) 
Starts a TAF session with another subsystem. 
e¢ SENDSESS (page 3-151) 
Sends commands and messages to VTAM applications. 
e LISTSESS (page 3-102) or LSESS (page 3-108) 


Displays the sessions that you are connected to and obtains information about 
each session. 


e RTRNSESS (page 3-147) or RSESS (page 3-146) 
Returns to a disconnected session with a VTAM application. 
e ENDSESS (page 3-68) or ESESS (page 3-70) 


Ends a session with a VTAM application. 


At any time during a full-screen session, you can disconnect from the session by 
pressing a disconnection key. A disconnection key can be any PA or PF key or the 
CLEAR key. It is defined on BGNSESS and the RTRNSESS Command. If you have not 
defined one, the PA1 key is your default disconnection key. 


For chained sessions (when you connect to another NetView and then from there to 
VTAM applications), the disconnection key for each session should be different. 


When you press the disconnection key, a disconnection menu is displayed. Among 
the several choices is the ability to go back to regular line mode. When you return 
to regular line mode, any messages that were delayed are now displayed. Here 
are what the options for the disconnection panel mean: 


e Option 7 interrupts the full-screen session and displays the regular line mode 
panel. Any messages that were delayed are now shown. You are now discon- 
nected from your full-screen session. To resume the session, you must enter 
the RTRNSESS command. If your terminal receives information for the discon- 
nected session, you are notified with this message: 


DST4791 DATA RECEIVED ON FULL~SCREEN SESSION FROM APPLID=applia 


Processing on the disconnected session stops until you enter the RTRNSESS 
command to resume the session. 


e Option 2 interrupts the session and shows the regular line mode panel. Any 
messages that were delayed are now shown. You are disconnected from the 
full-screen session. To return to it, you must enter the RTRNSESS command. You 
are not notified if any information is received for the disconnected session. 
Processing continues with your disconnected session as if you had left your 
terminal unattended. 
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e Option 3 has two meanings, depending on when you pressed the disconnection 
key. 


lf you pressed the key after entering a command or message but before you 
received a reply (your keyboard is locked), option 3 reads “SEND ATTENTION TO 
applid”. This option sends an attention interruption to a VTAM application. 


If you pressed the disconnection key when the keyboard was unlocked, option 
3 shows which key you pressed (either a PA, PF, or CLEAR key). This option 
sends the key command to the VTAM application where it is interpreted 
according to the specifications of that subsystem. In this way, one key can be 
used both by the subsystem and as the disconnection key. 


¢ Option 4 cancels the disconnection sequence and returns you to the full-screen 
session as it was before you pressed the disconnect key. This is the default if 
you enter anything except the options given. 


If you use the CLEAR key as a disconnection key, you must be careful using 
option 4, or using the RTRNSESS command. In these cases, the screen is erased 
when you return to the session. You must then press the refresh key as 
defined by the VTAM application to which you are connected. This is so the 
screen will be reformatted by the VTAM application. 


You can receive online help information on connecting to other VTAM applications 
(except if NetView is installed with the DASD Conservation Option) by entering the 
following command: 


HELP TAF 


Interconnected Networks 


The alias name translation facility lets networks be interconnected through a 
gateway node without each network having to rename logical units, classes of 
service, or logon mode names that are the same in more than one network. The 
names of your NetView programs must be unique. The commands that you can 
use are: 


e AINQ (page 3-8) 
Retrieves information from the alias translation table. 
e AUPD (page 3-17) 


Alters alias translation tables. 


Recording NetView Processing 


Use the TRACE command (page 3-174) to initiate a sequence trace that records (in 
either an internal table or the trace log) a sequence of NetView processing. 


Ending Commands or CLISTs 


The RESET command (page 3-140) or the ATTN key, ends some commands or 
CLISTS. 
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Error Recovery Commands 


Use the error recovery commands when the defined error count is reached for your 
operator identification or terminal. This condition is called error recovery status. 
The authorized operator receives the message Dsi143! indicating that your terminal 
or identification is in error recovery status. When your operator identifier is in 
error recovery status you cannot log on or off. Another operator, however, can 
issue one of the following commands: 


e AUTOTASK (page 3-23) 


Starts the automated operator specified. If the automated operator has 
stopped for any reason, the AUTOTASK command restarts it. If the automated 
operator was not previously defined, the AUTOTASK command creates one. 


e MOVE (page 3-116) 
Shifts work from one terminal to another. 
e START (page 3-156) 


Re-establishes a terminal in error recovery status or restarts a session in error 
recovery status between a terminal and its associated task. 


e STOP (page 3-162) 
Can be used to: 


— Stop a session between an operator and the terminal 
— Stop a particular task 

— Deactivate the network log 

— Deactivate the trace log 

— Deactivate a cross-domain NetView session 

— Deactivate a terminal session with NetView. 


Ending Your NetView Session 


The LOGOFF command (page 3-105) ends your session with NetView. See the note 
on Stopping NetView (page 3-162). 


CLIST Commands 


You can code sequences of commands (CLISTS) to perform functions that you might 
otherwise perform routinely. For example, a CLIST can perform a function when a 
particular message is sent to the system. 


CLISTS are stored in a file and are called by name. You can use CLISTs like other 
commands by entering the CLIST name and any data. You can enter many com- 
mands in sequence with very little effort. To find out how to write CLisTs, refer to 
NetView Command Lists. 


You can use the LIST command (page 3-99) or the BROWSE CLIST (page 3-33) to 
display the contents of a CLIST. 


Some CLISTs pause for you to enter information. During this pause, a P or W 
appears in the upper right hand corner of the screen. While the CLIST is pausing, 
you can enter only a screen control command or one of the following CLIST com- 
mands: 
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e GO (page 3-78) 


Tells the CLiST to continue processing. You can use this command to pass 
values to the CLIST. | 


¢ CANCEL (page 3-38) 
Stops CLIST processing. You can then enter any command you like. 
e STACK (page 3-155) 


Suspends CLIST processing so that you can enter other commands. The P or w 
in the upper right corner of the screen disappears when STACK is entered. 


¢ UNSTACK (page 3-179) 


Reinstates CLIST processing after a pause. The P or w in the upper right corner 
of the screen reappears when UNSTACK is used. 


CLISTS can also use a WAIT facility. When a CLIST is in WAIT status, a W appears in the 
upper right-hand corner of the screen. WAIT status is similar to &PAUSE, except that 
the CLIST is waiting for messages or other events, rather than operator data. Other 
commands may be delayed until the CLIST is finished. When in walt status, you can 
enter only GO, CANCEL, STACK, UNSTACK or screen control commands. When in WAIT 
status, you cannot enter data with the GO command. Use the GO command to end 
the WAIT without canceling the CLIST. 


The &wait function provides you with a way to specify a time-out option. When 
&WAIT is used under an automation task, &WAIT should specify a reasonable time-out 
value, so that the CLIsT does not get trapped in an endless wait. 


&PAUSE Should not be used under the automation task because it does not provide a 
time-out facility. 


Note: It is possible to use &PAUSE combined with using the GO command as a result 
of an automated message. The GO command in this case would serve to 
break the wait implied by the &PAUSE. 


You can use the STACK command to Suspend a CLIST WAIT so that you can enter com- 
mands or other CLISTs. You then use the UNSTACK command to reinstate the CLIST 
WAIT. 


BROWSE Command 


You can use the BROWSE command (page 3-33) to look at members in the CNMPNL1, 
DSICLD, DSIPARM, DSIVTAM, Or DSIPRF libraries. For vm these are separate files with a 
file type of NCCFLST or VTAMLST. 


On vn, the first time a VTAMLST file is browsed, an OPEN ERROR message will be 
received. The message results because NCCFLST is searched first, and then 


VTAMLST. Ignore the message; the function will execute correctly. 


The BROWSE command is also used to look at the network log. 
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3. Command Facility Command Descriptions 


This section describes the formats of the base the NetView program commands 
and CLISTs. These commands can be entered from the command facility or any 
other NetView component. 


The commands are listed in alphabetical order. Each command description 
includes the format and description of operands and, where applicable, usage 
notes, responses, and examples. 


The syntax and notation conventions used for the commands and CLISTs are as 
follows: 
e lItems shown in braces { } represent alternatives. You must choose one. 
For example, 


A 
B or {A|B/C} 
C 


indicates that you must specify one item only: A, B, or C. 
e lItems shown in brackets [ ] are optional. You may choose one. 
For example, 


A 
B or [A|B|C] 
C 


indicates that you may enter A, B, or C, or you may omit the operand. 


e Aseries of three periods (...) indicates that a variable number of items may be 
included in the list. 


e An underscored item shows the alternative, or default, the system will choose 
if you do not specify an item. 


For example, 


A 
B 


C 
If no operand is specified, B is assumed. 
e Lowercase italicized items are variable; substitute your own value for them. 
e Uppercase items must be entered exactly as shown. 
e Parentheses must be entered as shown. 


e Where operands can be abbreviated, the abbreviations are shown in capital 
letters. 


For example, 
All 


can be entered as A Or ALL. 
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e Where brackets ([ ]) are nested, you must include commas to denote the 
absence of the required positional operands. For example, 


Act» A 
[.B 
[,C]] 


To specify c only, enter ACT A,,C. 


For online help on the command facility (NCCF) commands, enter: 
HELP NCCF COMMANDS 
For help on a specific command, enter: - 


HELP command 


where command is the name of the command. 


The HELP command is not allowed if NetView is installed with the DASD Conserva- 
tion Option. 
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ACQ 


ee 


From a backup Sscp (VTAM), you can use the ACQ CLIST to acquire resources that 
belong to another sscp. This CLIST is used mainly for backup and recovery. 


The format of the ACQ CLIST is: 


- resname 
— £Act ee 

_tAll.om 8 Obie: u- ee ee en ee ere ae ec 

of lunameJogmede). i 


where: 


resname_ is the name of the resource to be acquired. This resource must be 
either an NCP major node or a physical unit within an NCP major node. 


Act specifies that the acquired resources should be activated. 


All specifies that all the acquired subordinate resources should also be 
activated, regardless of their defined ISTATUS (initial status) values in the 
resource definition statements. These values are set up by the system 
programmer. 


Comp specifies that during the activation of the major node, any subordinate 
minor nodes being acquired should also be activated, according to their 
ISTATUS values. This is the default. 


Only means to activate the acquired resource only, regardless of its defined 
ISTATUS values. 


U specifies that all the acquired subordinate resources should also be 
activated, according to their defined ISTATUS (initial status) values. 


luname is the name of a primary LU to which any device-type logical units are to 
be logged on. 


logmode _ is the logmode name to be used for any logon initiated for a logical unit 
as a result of this CLIST. 


Usage Note 


This CLIST generates the following VTAM command: 
VARY ACQ 


For more information on this command, see VTAM Operation. 


lf you omit a positional operand, you must indicate its absence by a comma. For 
instance, in the following example the third operand has been omitted: 


ACQ AO4NV4,ACT, ,NCFO1 
Example 


If HOST2 with NCP21 has failed, and you would like to take over its resources, you 
would use the following command: 


ACQ NCP21 
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Response 


If the Acq request is successful, the system responds with the following messages: 


ISTO971 VARY ACCEPTED 
IST6701 VARY ACQ PROCESSING FOR ID=NCP21 COMPLETE 
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ACT 


The ACT CLIST activates VTAM resources. 


The format of the ACT CLIST is: 


ACT 5 


where: 
resname 


All 


WARM 


ON 


OFF 


YES 


r esname 


LA], ‘Compl, Only, ula WARM] 

— L,ON|,OFFIILYES|.NO] eon! 
| [LOGON =/uname|,t LOGMODE = =logmode]] 

_[,DUMPSTA = -resname] — 


-&f LOADSTA = he ialadle 


so Ls -channeiname] _ oc | Ae | 
e “br RNAME = mresnameln RNAME = -(resnamet,. .fesname13)]_ 


is the name of the resource to be activated. 


specifies that the resource named in the resname 
Operand and all the subordinate resources should be 
activated, regardless of their defined ISTATUS values in the 
resource definition statements. These values are set up 
by the system programmer. 


specifies that all subordinate minor nodes should also be 
activated, according to their iSTATUS (initial status) values. 
This is the default. 


means to activate the resource specified by resname 
only; none of the subordinate resources should be acti- 
vated, regardiess of their defined iSTATUS values. 


specifies that the resource named in the resname 
operand and all of the appropriate subordinate resources 
defined with ISTATUS=ACTIVE should be activated. 


This option is valid only under mvs. It causes VTAM to 
restore the minor nodes to the status recorded for them 
in their configuration restart data set. However, if the 
major node’s configuration restart data set has never 
been used for status recording, or if the major node does 
not have a configuration restart data set, VTAM rejects the 
ACT CLIST. 


specifies that a switched SDLC line is to be put in answer 
mode. Do not use this operand with RNAME, LOGON, 
LOADSTA, DUMPSTA, U, LOGMODE, Or WARM. 


specifies that a switched SDLC line is to be taken out of 
answer mode. Do not use this operand with RNAME, LOAD, 
LOGON, LOADSTA, DUMPSTA, U, LOGMODE, Or WARM. 


specifies that the communication controller associated 
with the specified NCP is to be reloaded with the appro- 
priate NCP load module. 
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NO specifies that the communication controller associated 
with the specified NCP is not to be loaded during the proc- 
essing of this ACT CLIST. 


LOGON =luname is the name of a primary LU to which any logical units 
within the scope of this CLiST are to be logged on. 


LOGMODE = logmode is the logmode name to be used for any logon initiated for 
a logical unit as a result of this CLIST. 


DUMPSTA=resname applies only to the first activation of an NCP. DUMPSTA is. 
the name of a link station in an adjacent subarea node 
through which any later static dump operations for this 
NCP are to be carried out. 


LOADSTA=resname applies only to the first activation of an NCP. LOADSTA is 
the name of a link station in an adjacent subarea node 
through which any load operations for this NcP are to be 
carried out. 


U=channelname applies only to the activation of an inactive channel- 
attached NCP, or an SNA physical unit, or an inactive 
channel link to an adjacent host subarea. The U operand 
specifies the channel attachment to a communication 
controller, to an adjacent host, or to an SNA physical unit 
as it is Known to the operating system and through which 
VTAM is to establish connectivity to the specified NCP, 
VTAM, or physical unit. 


RNAME = resname applies only to the first activation of an NCP. RNAME Speci- 
fies the names of up to 13 SDLC link stations in adjacent 
NCP subarea nodes through which the specified NCP is 
attached to the network. It also specifies which SDLC link 
stations (and associated links) in adjacent NCP subarea 
nodes are to be activated automatically as part of the 
activation of the specified NCP. 


Usage Note 


This CLIST generates the following VTAM command: 
VARY ACT 


The ACT CLIST has been changed for release 2 to include await. It will not run com- 
mands under PPT. 


For more information on this command, see VITAM Operation. 
Example 


If you would like to activate physical unit P12175 and all resources under it, you 
would use the following command: 


ACT P12175,ALL 
Response 


If the ACT request is successful, the system responds with the following messages: 


IST0971 VARY ACCEPTED 
ISTO931 P12175 ACTIVE 


AGAIN 


The AGAIN command causes the last command or CLIST you entered to be rerun. 
The AGAIN command is valid only in the command facility. 


The format of the AGAIN command is: 


AGAIN. 
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AINQ 


The AINQ command retrieves information from the alias translation tables. 


The format of the AINQ command is: 


where: 


ORIGNAME=resname _ is the resource name as the origin network knows it. For 
a logical unit, this is an alias name. For a class of 
service (COS) or logon mode, this is the name of the cos 
or logon mode entry, Known in the originating network, 
that is equivalent to the entry specified for the target 
network. 


TARGNAME=resname is the resource as it is known to the target network. Fora 
logical unit, this is the real name. For a cos or logon 
mode entry, this is the local name defined in the target 
network. 


ORIGNET = resname is the source network (the identifier of the network to 
which the name type applies). If you do not specify this, 
ORIGNET becomes the network identifier of the network 
that NetView is running on. If NetView is running ina 
non-gateway host, you should specify the ORIGNET 


operand. 

TARGNET = resname is the network identifier of the target network. TARGNET is 
not required if you specify ORIGNAME and TYPE=LU. 

TYPE =LU specifies that the ORIGNAME Or TARGNAME is an LU. This is 
the default. 

TYPE=COS specifies that the ORIGNAME Or TARGNAME is a Class of 
service. : 

TYPE = MODE specifies that the ORIGNAME or TARGNAME is a logon mode. 

Usage Note 


Scope checking is done on the AINQ command and on the ORIGNET and TARGNET 
operands. The default values for ORIGNET, TARGNET, and TYPE can also be scope 
checked. 
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Example 
You are logged on to NetView in network NETA. You know that the alias name of a 
specific terminal LU in NETA is TERMA1, and you want to display the real name of that 


LU as it is known in target network NETB. 


To get translation information for TERMA1 in network NETB, enter: 
AINQ ORIGNAME=TERMAI ,ORIGNET=NETA, TYPE=LU, TARGNET=NETB 


Response 


The system responds with the following messages: 
DSI7431 INQUIRY DATA - ORIGNAME=TERMA] ,ORIGNET=NETA,TYPE=LU, TARGNET=NETB 


DST7441 INQUITRY RESULT - TARGNAME=TERMB1,TARGNET=NETB, CDRM=SSCPIDB 


The response contains the translated name (TERMA1 translates to TERMB1). 
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APPLS 


The APPLS CLIST displays active, inactive, or all application program minor nodes for 
each active application program major node. 


The format of the APPLS CLIST is: 


where: 


Act displays all active application program minor nodes within each major 
node. 


ALL displays all application program minor nodes within each major node. 
Inact displays all inactive application program minor nodes within each major 
node. 


Usage Note 


This CLIST generates the following VTAM command: 
DISPLAY APPLS 


For more information on this command, see VTAM Operation. 
Example 


To display all application programs, use the following command: 
APPLS ALL 


Response 


If the APPLS request is successful, the system responds with the following mes- 
sages: 


TSTQ971 DISPLAY ACCEPTED 

IST350I VTAM DISPLAY - DOMAIN TYPE = APPL MAJ NODES/NAMES 
TSTO89I VTAMSEG TYPE = APPL SEGMENT » ACTIV 

IST3601 APPLICATIONS: 

ISTO80I CDRM12 ACTIV ISTOLTEP ACTIV ISTATAQO CONCT 
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APPLSACT 


The APPLSACT CLIST displays VTAM application programs in a specific state. The 


default state is ACTIVE. 


The format of the APPLSACT CLIST is: 
APPLSACT  [ACTIVJINACT|CONCT] — 


where: 
ACTIV displays active application programs. This is the default. 
INACT displays inactive application programs. 


CONCT displays connected application programs. 
Usage Note 


This CLIST generates the following VTAM command: 
DISPLAY APPLS 


For more information on this command, see VTAM Operation. 
The APPLSACT CLIST cannot run under the PPT. 


CAUTION: 


Incorrect results may occur when running the APPLSACT CLIST while MSGMOD is on. 


Example 


To display all active applications, use the following command: 


APPLSACT 
Response 


The system responds with the following messages: 


CNM3071 APPLSACT : THE FOLLOWING ARE IN THE ACTIVE STATE 
CNM3081I APPLSACT : CDRM12 ISTNOP 
CNM3081 APPLSACT : CDRM21 CDRM22 


The active applications are CDRM12, ISTNOP, CDRM21, and CDRM22. 
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APPLSPEN 


The APPLSPEN CLIST displays sessions for particular application programs in a spe- 
cific state. The default state is PENDING ACTIVE. 


The format of the APPLSPEN CLIST is: 


where: 

applid is the application program for which sessions will be displayed. 

status is from one to eight characters long. Any session status matching the 
characters that you enter are displayed. The default is PND. 

Usage Note 


This CLIST generates the following VTAM command: 
DISPLAY NET 


For more information on this command, see VTAM Operation. 
The APPLSPEN CLIST Cannot run under the PPT. 


CAUTION: 
Incorrect results may occur when running the APPLSPEN CLIST while MSGMOD is on. 


Example 


To display all active sessions with the application named APPL1, use the following 
command: 


APPLSPEN APPL1,ACT 
Response 


If the APPLSPEN request is successful, the system responds with the following mes- 
sages: 


CNM309I APPLSPEN : NAME= APPL1 ,STATUS= ACTIV ,DESTIRED STATE= ACTIVE 
CNM3091 APPLSPEN : ACTIVE SESSIONS= 0003 SESSION REQUESTS = 0001 
CNM311I APPLSPEN : NAME STATUS SESSION ID 

CNM3131 APPLSPEN : APPL2 ACTIV-SEC 008000019D5EA889 

CNM3131I APPLSPEN : A5SUBA9 ACTIV-PRI 0000 0000 2 1 OURNETID 
CNM313I APPLSPEN : LUB203  ACTIV-SEC 9000 0000 3 1 NETB 

CNM3121 APPLSPEN : 3 SESSION(S) IN THE ACT STATE FOR APPL1 


Notice that since you requested a status of ACT, you received both ACTIV-SEC and 
ACTIV-PRI. 
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ASSIGN 


_ ASSIGN 


The ASSIGN command defines which operators receive copies of solicited mes- 
sages. The ASSIGN command with the DROP option removes assignments made with 
previous ASSIGN Commands. The ASSIGN command with the copy option identifies 
operators who receive copies of solicited messages. 


If ASSIGN defines Sysop or LOG as the primary receiver for a message for which 
message automation is in effect, then that message will not be automated. 


The format of the ASSIGN Command is: 
7 _Ms@= = {string|*} 


,PRI= (opediditoperid, pperide »- 
-‘Lsee= n{operial(oppria.e operie. ie 


a “Mse= fanning} oc WL 8 oe 
COPY = = (operid\ peri operi. » eg ter 


oar Ms@= ={etringiait} 
DROP = “(ata\cory) 


where: 

MSG = string identifies the messages that are to be routed to a specified 
operator, copied to other operators, or dropped from the routing 
tables. You can use an abbreviated form to specify groups of 
messages by prefixes by ending the prefix with an asterisk. For 
example, to specify all messages beginning with Dsi, use: 

DSI* 

MSG =* means to send all messages and commands to the operators 
listed. 

MSG = ALL drops all messages from the routing tables. 

PRI =operid is the list of operators to receive a copy of the solicited or 
authorized message. Only the highest priority operator in the 
list who is logged on will be notified. Operator priority is deter- 
mined by the order they are defined in DSIOPF. 

SEC = operid is the list of operators who are to receive copies of the solicited 


or authorized message. SEC applies only if PRI is also specified. 
All operators in this list receive the message if they are logged 
on, and at least one operator in the PRi list is logged on. 


COPY = operid specifies that the listed operators receive copies of solicited 
messages indicated by MSG whenever messages are sent to any 
terminal in this domain. If you specify MSG=", the listed opera- 
tors receive copies of all commands as well as all solicited mes- 
sages. The message sent to the copy receiver is flagged with a 
“+” in the last position of the domain ID field. Copy lets you 
collect network status information by routing access method 
events such as active or inactive messages. 
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operid is an operator’s ID or a list of operator ids. sysop, the system 
console operator, is a reserved ID. You can specify SYSoP to 
route messages to the system operator. If you specify operid as 
LOG, additional copies of the messages are sent to the network 
log. 


DROP=AUTH _ drops the specified messages from the PRI and SEC assignments. 
AUTH is the default. 


DROP =COPY drops the specified messages from the CoPY assignments. 
Usage Note 
The ASSIGN Command does not work for full-screen response messages. 


For multiple-line write-to-operator (MLWTO) messages, the entire set of message 
lines are assigned, as a unit, when the first line (control line) is assigned. Indi- 
vidual lines (other than the first line) cannot be assigned separately from the rest 
of the MLWTO. 


Example 


To direct all your solicited and authorized messages to OPER2, type: 
ASSIGN MSG=*, PRI=OPER2 ,SEC=0PER3 


Response 


All solicited and authorized messages will be sent to OPER2 if the operator is logged 
on. Copies of the messages will be sent to OPER3 if OPER2 and OPER3 are logged on. 
The messages will be marked with a % in the last position of the domain ID field on 
OPER2’sS screen and with an * on OPER3’s screen to indicate that they are solicited 
messages. 


Note: The functions of the ASSIGN command can also be performed using the ROUTE 
and CMD actions of the message automation table (see NetView Adminis- 
tration Reference IF...THEN.. automation statement). 
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AT 


The AT command sets a timer that causes a command or CLIST to be executed at the 
specified time of day. 


The format of the AT command is: 


AT  ~— time 


where: 

time indicates the time of day when the command is to be executed. 
Time is specified in the form hours:minutes, using a 24-hour clock. 

PPT specifies that the command is to be executed whether or not the 


operator is logged on when the timer expires. The following com- 


mands cannot be run under the PPT: AGAIN, AUTOWRAP, BGNSESS 
FLSCN, CANCEL, CLEAR, CLOSE, DISG, ENDSESS FLSCN, GO, HALT, INPUT, 
LINKDATA, LINKTEST, LIST, LISTSESS FLSCN, LOGOFF, MDMCNTL, MDMCNFG, 
MODIFY, MOVE, REPLY, RESET, RETRIEVE, RETURN, ROLL, ROUTE, RTRNSESS, 


SET, STACK; START, STARTDOM, STOP, SWITCH, UNSTACK. 


ID=reqname__a One- to eight-character identifier that you define for this timer 
request. The name cannot be ALL and cannot start with sys. 


command the command or CLIST to be executed when the timer expires. This 
must be the last operand. 


Usage Note 


Commands defined as “regular” or “both” when NetView was installed may be 
used with AT and EvERY. Commands defined as “immediate” cannot be used with 
AT. Commands scheduled under the PPT cannot run in the order that you specified 
if the value of the time operand is the same for each command. 


If the PPT is not coded, the command runs only if you are logged on at the indicated 
time. The command is run under the task where the AT command was issued, and 
all responses are sent back to that operator. 


No scope-checking is done for commands running under the ppt. Therefore, make 
sure that scope-checking for the PPT operand is defined during installation. 


Example 


If it is 14:05 and you want all the major nodes displayed 5 minutes from now, type: 
AT 14:10,MAJNODES 


To schedule the command MAJNODES to run at a specific time even if you are not 
logged on, use the following command: 


AT 14:10,PPT ,MAJNODES 
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Response 


You will see the following messages on your screen if the AT command runs suc- 
cessfully. 


DS1034I COMMAND SCHEDULED BY AT/EVERY COMMAND - commandtext 
DST2011 TIMER REQUEST SCHEDULED FOR EXECUTION ID=resname 
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AUPD 


Use the AUPD command to alter the alias translation tables. You can add defi- 
nitions, delete definitions, and replace definitions with a new set. 


The format of the AUPD command is: 


‘AUPD MEMBER = aliasname 
[,ORIGNET = {netid|*}] 
[, TYPE ={LU|COS|MODE|ALL}] 
-[,ADD|, DELETE] 


where: 

MEMBER = aliasname is the name of the member that is to be altered. For vm, 
this is the name of the NCCELST file. 

ORIGNET = netid identifies the network associated with the member. 

ORIGNET = * means all networks represented in the member and the 
alias tables are the subject of the request. 

TYPE=LU identifies LU as the type of alias definition to be updated 
in the table. 

TYPE =COS identifies Cos as the type of alias definition to be 
updated in the table. 

TYPE = MODE identifies the logon mode as the type of alias definition 
to be updated in the table. 

TYPE = ALL means that all types pertaining to the member name 
and ORIGNET in either the alias table or member are the 
subject of the request. If the TYPE operand is omitted, 
TYPE=ALL iS assumed. 

ADD lets you add new translation definitions to the alias 
translation tables or replace existing translation defi- 
nitions. If any records already exist in the translation 
table for these members, they are deleted before the 
new records are written. 

DELETE causes the translation definitions in ORIGNET and TYPE to 
be deleted from the translation tables. 

Usage Note 


The records read in from the definition tables are processed sequentially, one ata 
time. If there is a syntax error, an error message is issued, the record is ignored, 
and the next record is read. Unusual conditions, such as an input or output error 
while reading, can cause the AUPD request to stop with only part of the tables 
updated. The processed record count, along with any error messages, tell you 
whether the command was successful. 


When adding or replacing translation tables, the AUPD command reads the prede- 
fined translation records from the specified member and adds these records to the 
tables in storage. The AUPD command does not let you alter predefined records in 
the alias definition members. If you want to change a translation record that is cur- 
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rently in use, you must first determine the member name that contains the record 
to be changed. In order to change a translation record that is in use, you must 
change the record in the same member that was used by the alias task to construct 
the translation tables. The translation record can be changed using a system 
editor. Once the member contains the information you want, you can enter the 
AUPD command specifying, with the ADD option, the same member name you just 
changed. 


In vM, if you specify a member that does not exist, you will receive unpredictable 
results. 


Scope checking is done on the AUPD command and on the ORIGNET operand. 
Example 


If the NetView ALIASMEM initialization statement specified member names DEF001 
and DEF002, then the translation tables would be built as shown in Figure 3-1. 


The definitions are kept together by network name, but NetView remembers which 
member each definition record came from. 


If you entered: 
AUPD MEMBER=DEFOQQ1,ORIGNET=NETWRKA, DELETE 


then all the translation table entries for NETWRKA would be deleted because they 
were all defined in member DEF001. 


If you entered: | 
AUPD MEMBER=DEFO01,ORIGNET=NETWRKC DELETE 


then only the first two definitions (TERM1 and TERM2) for NETWRKC would be deleted. 
The definitions for NETWRKA would remain unchanged, and the TERM3 and TERM4 defi- 
nitions for NETWRKC would remain unchanged because they were defined in 
member DEF002. 


MEMBER-DEF001 Alias Tables 


ORIGNET NETWRKA 
LU TERM 1.... 
LU TERM 2.... 
LU TERM 3.... 
LU TERM 4.... 


NetView 
INITIALIZATION 


NETWRKA: 
LU TERM1.... 


ORIGNET NETWRKC LU TERM2.... 


LU TERM 1.... 


LU TERM 2.... LU TERMS.... 


LU TERM4.... 


NETWRKC: 


MEMBER-DEF002 LU TERM1.... 
ORIGNET NETWRKC 
LU TERM 3.... 
LU TERM 4.... 


LU TERM2.... 


LU TERMS3.... 


LU TERM4.... 


Figure 3-1. Example of Alias Translation Tables 
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The output from the AUPD command tells how many records were added to or 
deleted from the translation tables. 


The records read from the definition tables are processed sequentially, one ata 
time. Syntax errors cause error messages. The record is ignored and the next 
record read. Unusual conditions such as an input or output error while reading the 
member can cause the AUPD request to stop with only part of the tables updated. 
The processed record count, along with any error messages, tell you whether or 
not the command was successful. 


Response 


lf an AUPD command is issued and the ADD option is specified for a member not 
already initialized, the following messages appear at your terminal: 


*AUPD MEMBER=DEFO3 
-DS1751I COUNT OF RECORDS ADDED FOR UPDATE OF MEMBER=DEFO3 - 
ORIGNET=nn, LU=nn, COS=nn, MODE=nn 


if you issue an AUPD command with the DELETE option, the following messages 
appear: 


*AUPD MEMBER=DEFO3,DELETE 
-DSI7381 COUNT OF RECORDS DELETED FOR UPDATE OF MEMBER=DEFO3 - 
LU=nn, COS=nn, MODE=nn 


If you issue an AUPD command with the ADD option to replace an existing member, 
then message 738 will precede message 751. 
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AUTOMSG 


The AUTOMSG command activates the message automation function by specifying a 
member of DSIPARM to be used to identify the messages that are to invoke CLISTs or 
command processors. The command can also be used to display the status or 
deactivate all automation functions. 


The format of the AUTOMSG Command is: 


where: 


MEMBER= membername indicates the DSIPARM member you want to activate. 
For vn, this is file name ‘membername’ and file type 
NCCFLST. This member contains IF...THEN automation 
statements. The IF...THEN... automation statements 
identify the messages that are to invoke CLISTS or 
commands. 


The member loaded will be used for message auto- 
mation throughout the system, so only one member 
will be used at any time. The MEMBER operand can be 
used to change the member being used or to reload 
an updated member. 


OFF deactivates the message automation function. 


STATUS displays the name of the member in use, or a 
message stating that the message automation func- 
tion is inactive. 


TEST Allows the users to perform syntax checking of a 
message automation file. 


Note: No other operands are allowed with TEST (for 
example, STATUS, OFF). 


Usage Note 


It is recommended that this command be scope-checked to limit its use to the 
initialization CLIST and a small set of authorized operators. 


Only the operator who issues the AUTOMSG command is notified that a member has 
been activated. Since this activity affects all other operators on the system, you 
may want to use the ASSIGN command to route the notification message (Dsi410!) to 
all operators currently logged on. 


When a command or CLIST is automated, the command or CLIST is not processed 
immediately; it is queued to the task for processing at the next interrupt. 


If a command within a CLIST results in a message that in turn drives a second CLIST, 
the first CLIST will be processed completely before the second one is processed. If 
synchronous processing of the CLIST is necessary, you can use an &WAIT with the 
command, or the second CLIST can be invoked directly within the first CLIST. 
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The &walit function provides you with a way to specify a time-out option. When 
&WAIT is used under an automation task, &WAIT should specify a reasonable time-out 
value, so that the CLIST does not get trapped in an endless wait. 


&PAUSE should not be used under the automation task, because it does not provide 
a time-out facility. 


Note: You can use &PAUSE Combined with the GO command as a result of an auto- 
mated message. The GO command in this case would serve to break the wait 
implied by the &PAUSE. 


Example 


To deactivate the message automation function, type: 
AUTOMSG OFF 


Response 


You will see the following message on your screen: 
DST4111 MESSAGE AUTOMATION INACTIVE 


Example 


To display the name of the currently active message automation member, type: 
AUTOMSG STATUS 


Response 


You will see the following message on your screen: 
DS14101 DSIPARM MEMBER DSIMSGO1 BEING USED FOR MESSAGE AUTOMATION 


assuming that a member named DsiIMSGo1 is the one most recently activated by the 
AUTOMSG Command and that no AUTOMSG OFF has been issued. 


You will see the following message on your screen: 
DST411I MESSAGE AUTOMATION INACTIVE 


if no member has been activated since the last AUTOMSG OFF was issued. 
Example 


To activate DSIPARM member DsiMsGo1i for message automation, type: 
AUTOMSG MEMBER=DSIMSGO1 


Response 


You will see the following message on your screen: 
DS1T4101 DSITIPARM MEMBER DSIMSGO1 BEING USED FOR MESSAGE AUTOMATION 


if no errors were found in the IF-THEN automation statements in member DSIMSG01. 


You will see the following messages on your screen: 
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DST4121 THE FOLLOWING ERRORS WERE ENCOUNTERED PROCESSING DSIPARM MEMBER 
DSIMSGO1 


DS14151T END OF DSIMSGO1 ERROR DISPLAY 
DS14101 DSIPARM MEMBER DSIMSGO1 BEING USER FOR MESSAGE AUTOMATION 


if errors were found in the IF-THEN automation statements in member DSIMSGO1. 
Between message Dsi412! and DSI415i, for each error that is found in the member, a 
message appears indicating what error was found. The member containing the 
errors is activated without the entries in error unless the TEST operand was speci- 
fied as in the next example. 


If no valid statements were found in the member or the member itself could not be 
found, message Dsi416! appears, indicating that processing failed for the AUTOMSG 
command you issued. Then either message Dsi410! or DSi4111 appears, indicating 
that the status of the active message automation member is unchanged. 


Example 


To test DSIPARM member DSIMSGO1 without activating it, type: 
AUTOMSG MEMBER=DSIMSG01, TEST 


Response You will see the following message on your screen: 
CNM5011 TEST OF MESSAGE AUTOMATION FILE "DSIMSGO1" WAS SUCCESSFUL 


if the member DsimsGo1 contains all valid iF-THEN automation statements. If you 
specify TEST, the member name on the AUTOMSG command tests for errors, but no 
new member is activated. 
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AUTOTASK 


The AUTOTASK Command conditionally starts the automated operator specified. If 
the operator is already active, the command does nothing. If the automated oper- 
ator had been stopped for any reason, the AUTOTASK command restarts it. If the 
automated operator was not previously defined, the AUTOTASK command defines 
one. 


Note: An error message is issued if the operid was not defined to NetView. 


The format of the AUTOTASK command is: 


where: 
OPID=operid is the operator ID to use for the automation task. 


mvs CONSOLE = nn is an optional operand that can be used to dedicate the 
automation task to a specific MvS operator console. The 
value ‘nn’ is the console ID that uniquely identifies the 
Mvs console that can enter commands to and get 
responses from the automation task. 


mvs DROP is an optional operand that can remove the association 
between a specific mvs console and a NetView operator 
ID. If DROP is used, the automation task remains in its 
current state (active or inactive). 

Usage Note 


Scope checking is done on the AUTOTASK command and on the OPID, CONSOLE, and 
DROP Operands. 


Example 


To start an automation task when NetView starts up, include the following in your 
initial CLIST (NCCFIC): 


AUTOTASK OPID=AUTOOP 
Response 


The AUTOTASK command will return a return code to the CLIST when it is invoked ina 
CLIST. 
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AUTOTR 


The AUTOTR CLIST sets the buffer trace on or off for cross-domain resources 
belonging to the CDRM minor node name specified. 


The format of the AUTOTR command is: 


where: 


resname specifies a CDRM minor node name (required). 


ON starts the buffer trace (default). 
OFF stops the buffer trace. 
ALL specifies that trace ON or OFF is to affect all resources in ACF/s or 


ACF/S----Y status under the designated CDRM, including any exceptions 
that your installation may have coded into the CLIST. 


Usage Notes 


This command generates the following VTAM commands: 


DISPLAY ID 
MODIFY TRACE 


For more information on these commands, see VTAM Operation. 
lf you omit a positional operand, indicate its absence with a comma. 
The AUTOTR CLIST cannot run under the PPT. 


You can customize this CLIST so that buffer traces can be started only for specific 
resources. 


CAUTION: 
Incorrect results may occur when running the AUTOTR CLIST while MSGMOD is on. 


Examples 
AUTOTR CDRM10,0N 
activates buffer trace for cross-domain resources under the specified corm. If you 


customize the CLIST to affect only certain terminals under the named CDRM, then 
buffer trace will be started for those terminals only. 


AUTOTR CDRM10,0ON,ALL 


activates buffer trace for all terminals under node CDRM10, in ACT/S or ACT----Y status, 
regardless of any customization statements coded in the CLIST. 


AUTOTR CDRM10, OFF 


inactivates buffer trace for the CDRSCS under CDRM10. 
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AUTOWRAP 


The AUTOWRAP Command controls whether your terminal will be locked when the 
screen is full of data, or if and when the screen will be automatically overlaid with 
new data. 


The format of the AUTOWRAP Command is: 


AUTOWRAP § [0|NNn|NO] 


where: 

0 means the system will overlay the screen when it is full. This is the 
default. 7 

nnn is the number of seconds (1-999) that the system will wait before it unlocks 


the screen and presents new information. 


NO specifies that autowrap is to stop. With AUTOWRAP NO you must press a PF, 
PA, CLEAR, Or ENTER key to unlock the screen. 


Usage Note 
The AUTOWRAP Command is both a regular and an immediate command. 


The screen is always either unlocked, locked, or held. When the screen is 
unlocked, new messages can be added to the bottom of the output area. When the 
screen is locked, it must be unlocked to let the system write the next message at 
the top of the screen. When the screen is held, the system will not write over the 
message already on the screen until you unlock the screen (by pressing the ENTER 
Or CLEAR key) from the keyboard only. You hold the screen when you want to read 
it and not have the system write over it. 


Specify AUTOWRAP 0 only if you are sure you do not want NetView to stop for you to 
read the messages on the screen. Specifying AUTOWRAP 0 is useful when you leave 
your terminal and wish to avoid delay. 


AUTOWRAP does not apply to full-screen mode. When you return from full-screen 
mode, the AUTOWRAP you had before is still in effect except that time expiration of 
AUTOWRAP will not cause the first screen to go away. 


Example 


To set your display so that it will not wrap, enter: 
AUTOWRAP NO 


All you will see are the date and time in the upper right-hand corner of your 
screen. 


To set your display so that it will wrap, enter: 
AUTOWRAP 


You will see an A in the upper right hand corner of your screen. 
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Response 


lf you type AUTOWRAP 0 Or AUTOWRAP nnn, you will see an A at the top right corner of 
your screen. You do not see an A if you enter AUTOWRAP NO. If you hold the screen, 
you will see an H where the AUTOWRAP A normally appears. 


lf you have turned on AUTOWRAP successfully, you will see the following in the 
immediate message area: 


DSI0821 AUTOWRAP STARTED 


If you ask for the AUTOWRAP NO, you will see this message: 
DSI083I AUTOWRAP STOPPED 
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BFRUSE 


The BFRUSE CLIST displays information about VTAM buffer usage. 


The format of the BFRUSE CLIST is: 


Usage Note 


This CLIST generates the following VTAM command: 
DISPLAY BFRUSE 


For more information on this command, see VTAM Operation. 
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BFSESS 


The BFSESS CLIST starts a full-screen session with another subsystem. 


The format of the BFSESS CLIST is: 


where: 

applid is the name of the logical unit in the destination subsystem. 

srclu is the name of the secondary logical unit for the session. 

disc is the disconnection key for the session (PAn, PFn, Or CLEAR). If you do 


not specify this operand, the default key is the PA1 key. 


logmode_ is the logmode entry indicating the desired session bind operands. The 
default value is M2SDLCNQ. 


vigil specifies whether or not to notify you of messages. This can be either y 
(yes) or N (no). Y is the default. 


DEFER _ specifies that the actual establishment of the session is deferred until 
the destination subsystem chooses to initiate the session. Deferring 
permits another subsystem to acquire the logical unit. Not all destina- 
tion subsystems initiate sessions. Your systems programmer can tell 
you whether a particular subsystem initiates the session. 

Usage Note 


This CLIST generates a BGNSESS Command. See “BGNSESS” on page 3-29 for more 
information. 


If you omit a positional operand, you must indicate its absence by a comma. 


Scope checking is done on the BGNSESS command and on the APPLID and SRCLU 
operands. 


Example 


To begin a full-screen TSO session (Mvs), enter the following CLIST: 
BFSESS TS01 
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BGNSESS 


Use the BGNSESS command to start a session with another subsystem. 


The format of the BGNSESS command is: 


BGNSESS 


OPCTL | 

,APPLID = wpplia.. 
[ SRCLU = srclu] 
[,SESSID = sessionid] 
[ LOGMODE = logmode] 
[,DEFER] | 
[,TEXT=text] — 

FLSCN 

,APPLID=applid — 
[,SRCLU=srclu] — | 
[,LOGMODE = logmode] | 
[VIGIL ={Y|[N}] © 
[,pD= cexsrapleenicueD) 
[,DEFER] ~ 
[,TEXT=text] 

where: 

OPCTL starts an operator-control session. 

FLSCN starts a full-screen session. 

APPLID = applid specifies the name of the logical unit in the destination 
subsystem. Scope checking is done on this operand. 

SRCLU=srclu specifies the name of the logical unit you are using as a 
secondary logical unit for this session. Scope checking 
is done on this operand. 

SESSID = sessionid is a one- to eight-character session identifier associated 
with this specific operator-control session. You must 
use this session identifier in front of the command text 
sent with every SENDSESS command. The identifier is 
displayed in the domain name field of the screen to tell 
you where the message came from. If you do not 
specify SESSID, the APPLID value is used as the session 
identifier. You must use SESSID if you establish multiple 
operator-control sessions to the same destination. All 
session identifiers used by one operator must be dif- 
ferent from any other SESSID Or APPLID. 

LOGMODE = logmode is the logmode entry indicating the desired session BIND 


operands. If not specified, LOGMODE becomes the 
default BIND image table entry as defined to VTAM. If you 
have used the DEFER operand, do not use the LOGMODE 
operand. 
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DEFER specifies that the actual establishment of the session is 


deferred until the destination subsystem chooses to ini- 
tiate the session. Deferring permits another subsystem 
to acquire the logical unit. Not all destination subsys- 
tems initiate sessions. Your system programmer can 
tell you whether a particular subsystem initiates the 
session. 


TEXT =text is the text associated with the LOGON command of the 


subsystem you want started. If you specify TEXT, it must 
be the last operand. If you have used the DEFER 
operand, do not use the TEXT operand. Ask your system 
programmer for the correct operand. 


VIGIL=Y means that you will hear the terminal alarm when infor- 


mation is sent to NetView. You will also hear this alarm 
when you press ENTER Or a PA or PF key. The alarm will 
continue until you disconnect from the session. You 
may then return to your session and the alarm will not 
sound until another message (information) is received. 


VIGIL=N means that you will not hear the terminal alarm when 


information is sent to NetView. You can display the 
messages (information) when you disconnect from the 
subsystem. | 


D=PA1|PAn|PFnjCLR specifies which key is the disconnection key for this full- 


screen session. PA1 is the default. 


Usage Note 


Things you should know for operator-control sessions: 


For 8100/DPPX systems, you must have a separately defined logical unit for each 
8100. 


For IMS/VS and CICS/vs systems, you must have a logical unit specified on the 
BGNSESS OPCTL command if you currently have no OPCTL sessions. 


lf BENSESS OPCTL Commands are entered without specifying a logical unit name, 
SRCLU defaults to the last SRCLU that was explicitly specified by this operator on 
@ BGNSESS OPCTL Command that is still active. Specify Sessip if the default is 
used. 


No more than 30 operator-control sessions can be established from one SRCLU 
value. 


Things you should know for full-screen sessions: 


e Only one SRCLU operand for each operator can be used for full-screen sessions. 


e The SRCLU operand is required for the first BGNSESS FLSCN Command. It will be 
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ignored if it is specified on subsequent BGNSESS FLSCN commands, if at least 
one full-screen session is active. 


If you logged on to your terminal with a non-query logmode (see NetView 
Installation and Administration Guide), you cannot use the terminal access 
facility to go to another application with a query logmode. Both logmodes must 
be non-query. For example, if you use the following command: 


LOGON APPLID(CNMO1) LOGMODE (M2BSCNQ) 


and then try to use the terminal access facility to go to an application with 
LOGMODE MSDLCQ, you receive the following message: 


DS14621 INVALID BIND PARAMETER 


e For terminal access facility sessions, always use an SDLC logmode. Sample 
supplied logmodes (for example MSDLCQ and MSDLCNQ) can be found in the 
NetView Installation and Administration Guide. 


e No more than 30 full-screen sessions can be established for one operator. 


e For mvs, when starting a session with TSO, you should use one of the TSO LU 
names and not the AcB name, which is always TsO. If you try to start a session 
with Tso rather than the appropriate ACB name, you will receive the following 
message: 


DST461I SRCLU=xxx: IS UNABLE TO ACCEPTA SESSION FROM APPLID=TSOxxx 


Although you will not be able to use the session, you must issue an ENDSESS 
command to end the session. 


e The viGIL operand replaces the existing INT operand. INT is still a valid operand 
but now functions the same way as VIGIL; the operator is no longer interrupted 
but only alerted by the terminal alarm of information coming to NetView. 


if a session is started with a destination system that does not automatically send 
an initial output screen (for example, the cics/vs “good morning” screen), you must 
enter RTRNSESS before you can begin sending your initial input panel. 


Example 


To begin a full-screen session with CICS (MVS) USing MYCICS as the session ID name 
and TAF555 as the FLSCN SRCLU, type: 


BGNSESS FLSCN,APPLID=CICS,SRCLU=TAF555 


Note: When using AUTOWRAP you will need to press ENTER to display full-screen 
output. 


Response 


When you have started a full-screen session successfully, you receive these mes- 
sages: 


DS14561 SESSION STARTING TO APPLID=applid FROM SRCLU=srclu 
SESSID=sessionid 

DSI463A A SESSION HAS BEEN STARTED TO APPLID=applid FROM 
SRCLU=srclu 

DST493A PRESS BNTER TO DISPLAY FULL SCREEN 
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BOSESS | 


The BOSESS CLIST starts an operator control session with another subsystem which 
supports line by line. The operator control session will allow you to send com- 
mands and receive responses from subsystems, line by line. Thus, you can have 
concurrent sessions with one or more subsystems. 


The format of the BOSESS CLIST is: 


where: 

applid is the name of the logical unit in the destination subsystem. 

srclu is the name of the secondary logical unit for the session. 

sessid is a one- to eight-character session identifier associated with this spe- 


cific operator-control session. You must use this session identifier in 
front of the command text sent with every SENDSESS CLIST. 


logmode_ the logmode entry indicating the desired session bind operands. The 
default is M3767. 


DEFER _ specifies that the actual establishment of the session is deferred until 
the destination subsystem chooses to initiate the session. Deferring 
permits another subsystem to acquire the logical unit. Not all destina- 
tion subsystems initiate sessions. Your systems programmer can tell 
you whether a particular subsystem initiates the session. 


Usage Note 


This List generates a BGNSESS command. See “BGNSESS” on page 3-29 for more 
information. 


If you omit a positional operand, you must indicate its absence by a comma. 
Example 


To begin an operator session with ims, use the following command: 
BOSESS IMS,TAFFL11,IMSA 


You could now send any supported command to IMS. 
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BROWSE 


The BROWSE CLIST allows you to look at the network log, members of a partitioned 
data set (Mvs), or files (vM). The names of the partitioned data sets and files are: 


CNMPNL1_ contains panels. 
DSICLD contains CLISTs. 


DSIPARM contains system operand definitions, data service definitions, 
command definitions, and operator definitions. 


DSIPRF contains profile definition statements, such as your class, profile, and 
span. 


DSIVTAM contains node definition statements. 


For mvs, the members are contained in a partitioned data set (PDS). For vm, these 
files have a file type of NCCFLST Or VTAMLST. 


The format of the BROWSE CLIST is: 


BRowse {NETLOGA|NETLOGI|NETLOGP|NETLOGS|membername} 


where: 

NETLOGA is the active network log. 
NETLOGI is the inactive network log. 
NETLOGP is the primary network log file. 
NETLOGS is the secondary network log file. 


membername is the member name in the CNMPNL1, DSICLD, DSIPARM, DSIPRF, or 
DSIVTAM library, or a file with a filetype of NCCFLST or VTAMLST. 


Usage Note 


The storage needed to browse a file or member varies depending on file or 
member size; the larger the file or member, the more storage needed. However, 
browsing the network log is NOT affected by storage size. 


If both network log files are inactive, specify either NETLOGP or NETLOGS. 


Because of the length of the information or the effect of left and right scrolling ina 
network log line that contains double byte characters (DBCS) data, up to three con- 
secutive dummy characters (periods) may appear at the start and end of the line to 
correct DBCS information that is incomplete. Invalid DBcs characters are replaced 
by double-byte asterisks. 


For MVS, if you specify a member name to browse, NetView searches the libraries 
in the following order: 


. CNMPNL1 
DSICLD 
DSIPRF 
. DSIPARM 
DSIVTAM. 


aR ON 4 


Chapter 3. Command Facility Command Descriptions 3-33 


For vM, if you specify a file name to browse, NetView searches in the following 
order: 


1. NCCFLST 
2. VTAMLST. 


The first time a VTAMLST file is browsed (in VM), an OPEN ERROR message will be 
received. The message results because NCCFLST is searched first, and then 
VTAMLST. Ignore the message; the function will execute correctly. 


When you use this CLIST, the browse facility remains on the NetView component 
stack that is used with ROLL until the browse facility is ended. 


You can browse a CLIST using a command synonym name. A message indicating 
the actual name of the CLIsT file appears on the second line of the browse screen. 


You cannot use BROWSE to view the trace log. You can print the network log or the 
trace log using CNMPRT (MVS) and DSIPRT (VM). 


In addition to the PF keys that are used throughout NetView, the browse facility pro- 
vides the following additional PF key functions: 


PF4 - Top This key moves the screen to the top of the information 
being browsed. 


PF5 - Bottom This key moves the screen to the bottom of the information 
being browsed. 


PF7 - Backward This key moves the screen backward through the informa- 
tion being browsed. You can vary the amount that you go 
back by entering one of the following values in the 
SCROLL field: 


e Half—Moves back half a screen 

e Max—Moves back to the beginning of the member 
being browsed 

e Page—Moves back one screen 

e nnnn—A one- to four-digit number, specifying the 
number of lines to move back. 


PF8 - Forward This key moves the screen forward through the information 
being browsed. You can vary the amount that you go 
forward by entering one of the following values in the 
SCROLL field: 


e Half—Moves forward half a screen 

¢ Max—Moves forward to the end of the member being 
browsed 

e Page—Moves forward one screen 

e nmnnn—A one- to four-digit number, specifying the 
number of lines to move forward. 


PF9 - Repeat FIND This key causes the previously entered FIND command to 
be issued again. 


PF10 - LEFT Network log only. Moves the screen left over the network 
log. You can vary the amount that you go left by entering 
one of the following values in the SCROLL field in the upper 
right corner of the panel: 
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PF11 - RIGHT 


PF12 - ALL or ONE 


PF12 - Position cursor 


Example 


e Half—Moves to the left half a screen 

e Max—Moves the screen to the left-hand margin of the 
log 

e Page—Moves to the left one screen 

e nnnn—A one- to four-digit number that specifies the 
number of columns to move left. 


Network log only. Moves the screen right over the network 
log. You can vary the amount that you go right by entering 
one of the following values in the SCROLL field in the upper 
right corner of the panel: 


e Half—Moves to the right half a screen 

e Max—Moves the screen to the right-hand margin of the 
log 

e Page—Moves to the right one screen 

e nnnn—A one- to four-digit number that specifies the 
number of columns to move right. 


Network log only. This key toggles between ALL and ONE. 
ALL means that any messages that have set off the impor- 
tant message indicators appears in their corresponding 
indicator’s color. ONE means that if an important message 
indicator is selected, messages corresponding to that indi- 
cator number appears in that indicator’s color while all 
other messages appear in turquoise. The words ALL or ONE 
are located next to the PF key explanation on the bottom of 
the screen, to let you know which mode you are using. 


Library browse only. This key positions the cursor in the 
command field. 


To look at the CLIST ACT, type: 


BRowse ACT 


The following screen is displayed: 
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Figure 3-2. Sample BROWSE Panel 
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Notice the information: 
LINE 0001 TO 0018 OF 0325 


on the top line of the screen. This information indicates the position of the screen 
in the member being browsed. 


0001 _ _siis the first line being displayed. 

0018 is the last line being displayed. 

0325 is the number of lines in the member or file being browsed. 

MVS Note: If a member of a partitioned data net with secondary extents is edited 


while NetView is up, it is possible that BROWSE will then be unable to find that 
member (until next time NetView is down and brought back up). 
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CANCEL 


The CANCEL command ends a CLIST that Is in ACTIVE, WAIT, PAUSE, Or STACK status, 
without running the rest of the commands. If the CLIST is in a pause or wait status, 
NetView removes the P or w from the upper right corner of the screen. Canceling a 
nested CLIST cancels the entire nested family. 


The format of the CANCEL command is: 


Usage Note 


The CANCEL command is both a regular and an immediate command. 
Example 


If the CLIST MYCLIST is waiting and you want to cancel it, type: 
CANCEL 


Response 


If the CANCEL request is successful, you get this message on your screen: 
DSTO09I COMMAND LIST MYCLIST CANCELED BY OPERATOR REQUEST 
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CANCMD 


The CANCMD command allows you to cancel any outstanding network product 
support (NPS) commands except for CANCMD, DISPCMD, and MDMCNFG. You can cancel 
a command entered under either your ID or another operator’s ID. 


The format of the CANCMD command is: 


CANCMD {TAG=tag|ID=resname|sP = spname} 


where: 

TAG =tag specifies the unique identifier of the command being canceled. 
Use DISPCMD to obtain this value. 

iID=resname specifies the network name of a device. 

SP =spname specifies the network name of a service point. 

Usage Note 


You can use the CANCMD command to cancel a Network Product Support (NPS) 
command. In some cases, several commands may be issued for a given device, 
but only one goes to that device at a time. Thus, you may need to cancel an active 
command to let other commands be sent to that device. Note: If any MDMCNFG 
commands are outstanding for a certain iD, and the CANCMD is issued for that ID, no 
commands including the MOMCNFG command can be canceled. 


When a command is canceled, its processing is terminated. However, no action is 
taken to undo any effects of the command, or to reset the state of the device’s 
physical unit. Depending on when the command is entered, the command may or 
may not have taken effect. You may need to issue the INACT and ACT commands to 
reset the device’s physical unit. 


If the NPS DST appears to be hung due to all of its solicited DSRBs being in use 
(perhaps because NPS commands never completed), use the PURGE command with 
the DST keyword to free up the DSRBS (PURGE DST = DSIGDS,REQ= ALL,OP = DSIGDS). Once 
the DSRBs are freed up, then use CANCMD to free the NPS storage associated with the 
commands that are queued up under the nPs task. 


Scope checking is done on the CANCMD command and on the TAG, ID, and SP oper- 
ands. 


Example 


To cancel any outstanding commands sent to device NY3710, type: 
CANCMD ID=NY3710 
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CCPDR 


The CCPDR command sends dynamic reconfiguration data to a 3710 Network Con- 
troller. You cannot enter the CCPDR command. This command must be issued from 
a CCP-generated CLIST, or it will be rejected. It will also be rejected if it is issued 
under the PPT. 


The format of the CCPDR command is: 


where: 


resname specifies the network name of the 3710 to which data is to be sent. 


F indicates that this is the first CCPDR command in a sequence. 

M indicates that this is the middle CCPDR command in a sequence. 

L indicates that this is the last CCPDR command in a sequence. 

O indicates that this is the only CCPDR command in a sequence. 

data specifies the data (in hexadecimal) to be sent to the specified 3710. 
Usage Note 


The resname operand can be scope-checked to control which operators can 
dynamically reconfigure each 3710. The scope for the resname operand can be 
controlled with the KEYCLASS statement in the initialization decks. See the NetView 
Installation and Administration Guide. 

Return codes from this command are: 


0 Successful processing of the command. The request was sent to the 3710, and 
the 3710 accepted and processed the request successfully. 


4 Error in processing the request. The error occurred in transmitting the request 
to the 3710, or the 3710 rejected the request. 


Scope checking is done on the CCPDR command. 
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CCPLOADF 


The CCPLOADF command sends signals that a load sequence has completed. The 
load sequence sends configuration definition data to a 3710 Network Controller. 
You cannot enter the CCPLOADF command. This command must be issued from a 
ccp-generated CLIST, or it will be rejected. It will also be rejected if it is issued 
under the PPT. 


The format of the CCPLOADF command is: 
CCPLOADF resname 


where: 


resname specifies the network name of the 3710 to which data is to be sent. 
Usage Note 


The resname operand can be scope-checked to control which operators can load 
each 3710. The scope for the resname operand can be controlled with the 
KEYCLASS statement in the initialization decks. See the NetView Installation and 
Administration Guide. 


Return codes from this command are: 


O Successful processing of the command. The request was sent to the 3710, and 
the 3710 accepted and sent the request successfully. 


4 Error in processing the request. The error occurred in transmitting the request 
to the 3710, or the 3710 rejected the request. 
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CCPLOADI 


The CCPLOADI command sends signals that a load sequence has started. The load 
sequence sends configuration definition data to a 3710 Network Controller. You 
cannot enter the CCPLOADI command. This command must be issued from a 
ccp-generated CLIST, or it will be rejected. It will also be rejected if it is issued 
under the PPT. 


The format of the CCPLOAD!I command is: 


where: 


resname specifies the network name of the 3710 to which data is to be sent. 
Usage Note 


The resname operand can be scope-checked to control which operators can load 
each 3710. The scope for the resname operand can be controlled with the 
KEYCLASS statement in the initialization decks. See the NetView Installation and 
Administration Guide. 


Return codes from this command are: 


0 Successful processing of the command. The request was sent to the 3710, and 
the 3710 accepted and sent the request successfully. 


4 Error in processing the request. The error occurred in transmitting the request 
to the 3710, or the 3710 rejected the request. 
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CCPLOADT 


The CCPLOADT command sends load text information to a 3710 Network Controller. 
You cannot enter the CCPLOADT command. This command must be issued from a 
ccP-generated CLIST, or it will be rejected. It will also be rejected if it is issued 
under the PPT. 


The format of the CCPLOADT command is: 


CCPLOADT resname 
,data 


where: 
resname specifies the network name of the 3710 to which data is to be sent. 


data specifies the load text (in hexadecimal) to be sent to the 3710. 
Usage Note 


The resname operand can be scope-checked to control which operators can load 
each 3710. The scope for the resname operand can be controlled with the 
KEYCLASS statement in the initialization decks. See the NetView Installation and 
Administration Guide. 


Return codes from this command are: 


0 Successful processing of the command. The request was sent to the 3710, and 
the 3710 accepted and sent the request successfully. 


4 Error in processing the request. The error occurred in transmitting the request 
to the 3710, or the 3710 rejected the request. 
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CDRMS 


The CDRMS CLIST displays cross-domain resource manager (CDRM) major nodes 
known in your domain. 


The format of the CDRMS CLIST is: 


where: 


Act displays information about all the active CDRM minor nodes within each 
major node. 


Inact displays information about all inactive CDORM minor nodes within each 
major node. : 


ALL displays information about all CDRM minor nodes within each major node, 
regardless of their status. 


Usage Note 


This CLIST generates the following VTAM command: 
DISPLAY CDRMS 


For more information on this command, see VTAM Operation. 
Example 


To display all the CDORM major nodes for your domain, type: 
CDRMS 


Response 


If the CDRMS request is successful, the system responds with the following mes- 
sages: 


TISTQ97I DISPLAY ACCEPTED 

TST3501 VIAM DISPLAY - DOMAIN TYPE = CROSS-DOM. RSRC MGR 
TSTO89I XNETCDRM TYPE= CDRM SEGMENT sACTIV 

IST4821 NETAHOST NEVAC ,SUBAREA = N/A ,EL = N/A »NETID=NETA 
TST4821 NETBHOST ACTIV ,SUBAREA = 075 ,EL = 000012 ,NETID=NETB 
IST3141 END 


Notice that for each active major node, the name, status, subarea number, element 
address, and the network ID (if one exists) of each subordinate CDRM minor node is 
listed. 
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CDRSCS 


The CDRSCS CLIST displays cross-domain resource (CDRSC) major nodes known in 
your domain. 


The format of the CDRSCS CLIST is: 


corscs_ [Act|Inact|ALt] 


[,netid] 
where: 
Act displays information about all the active CORSC minor nodes within each 
major node. 


Inact displays information about all inactive CORSC minor nodes within each 
major node. 


ALL displays information about all CORSC minor nodes within each major node, 
regardless of their status. 


netid displays only those CDRSCS within the indicated network. If you only use 
the netid operand, omit the comma. 


Usage Note 


This CLIST generates the following VTAM command: 
DISPLAY CDRSCS 


For more information on this command, see VTAM Operation. 
Example 


To display all the CDRSCS major nodes for your domain, type: 
CDRSCS 


Response 


If the CDRSCS request is successful, the system would respond with the following 
messages: 


{STO971 DISPLAY ACCEPTED 

IST3501 VTAM DISPLAY - DOMAIN TYPE = CROSS-DOM. RESOURCES 
ISTO89I ISTCDRDY TYPE= CDRST SEGMENT sACTIV 

IST4831I NC10Q001 ACT/S----Y, CDRM = CDRM1O 

IST4831 L1920 ACT/S----Y, CDRM = CDRM10 

TST3141 END 


Notice that for each active CDRSC major node, the name, status, owning CDRM and 
NETID of each subordinate CDRSC minor node is listed. 
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CHANGEFP 


The CHANGEFP CLIST redefines the designated primary focal point host or both the 
designated primary and backup focal point hosts that receive forwarded messages 
and alerts from a given distributed host. 


The format of the CHANGEFP CLIST is: 


where: 

target specifies the name of the distributed host whose primary focal 
point host or primary and backup focal point hosts are to be 
changed 

backup is an optional operand that specifies the focal point host to 
which all forwarded messages and alerts are sent when the 

primary focal point is not available 
Usage Note 


Use the CHANGEFP CLIST only with alert and message forwarding. 
The domain from which the CLIST is executed becomes the new primary focal point. 


If you do not specify the backup, the current backup focal point host setting 
remains unchanged. 


The target host, new primary focal point host, and backup focal point host must be 
defined to NetView via RRD system definition statements. 


The service operator (SERVOPER) must be available for logon at the target domain. 


The alert and message forwarding automated operator (DNAUTOOP) ID must be active 
at both the domain running the CLIST and the target domain. 


If persistent monitoring exists between the target and the old primary focal point, 
this session is terminated. 


If persistent monitoring is to exist between the target and new primary focal point 
hosts, the session is started upon arrival of the next message or alert to be for- 
warded from the target host. 


Scope checking is recommended for the CHANGEFP CLIST. Operators should be 
authorized to use this CLIST by their systems programmer. 
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You cannot isSue CHANGEFP from a distributed host. 
You can change a distributed host into a focal point (intermediate focal point), by 
following these steps: 


e If you do not want to recycle NetView, you can make a temporary change by 
doing the following: 


— Run the LOGAUTOF (LOGAUTO!) CLIST under the alert and message forwarding 
automated operator (DNAUTOOP) after customizing it according to the com- 
ments contained with the CLIST. 


— Start DSIFPMAT (DSIINMAT) as the message automation table by entering 
AUTOMSG MEMBER = DSIFPMAT (AUTOMSG MEMBER = DSIINMAT) at a NetView 
console. 


e Otherwise, you can make a permanent change by doing the following: 


— Follow the instructions for setting up a focal point (intermediate focal point) 
that are in the NetView Installation and Administration Guide. 


— Recycle NetView. 


For additional information on alert and message forwarding, refer to the NetView 
Installation and Administration Guide. 


Examples 


The authorized operator in the domain CNMo1 issues: 
CHANGEFP CNMO2,CNM99 


To set the primary focal point host to CNMo1 and the backup focal point host to CNMg99 
for the target domain CNMo2. 


CNMBB CNMPP CNM99 CNMQ1 
| Backup | | Primary | | Backup |_| Primary | 
CNMO2 CNMQ2 
| Distributed | | Distributed | 
Host Host 
(before conmand issued) (after command issued) 


The authorized operator in the domain CNMo1 issues: 
CHANGEFP CNMOZ 


To set the primary focal point host to CNM0o1. The backup remains the same as 
before for the target domain CNM02. | 


For backup on the above example, CNu99 would be CNMBB. 
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CLEAR 


The CLEAR command clears the screen. 


The format of the CLEAR command is: 


Usage Note 


The CLEAR command works similarly to the CLEAR key. 


Held messages or reply messages are rewritten to the screen. 
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CLOSE 


The CLOSE command ends NetView. 


The format of the CLOSE command is: 


CLOSE  [NORMAL|IMMED|DUMP] 


where: 


NORMAL means that you will end NetView in an orderly way. NetView sends a 
message to all active operators to tell them a shutdown will occur 
after current sessions are logged off. New logons from NetView ter- 
minals and new cross-domain logons are not accepted. The sessions 
that already exist continue until they are logged off. NetView restricts 
operators from using certain commands that would start new NetView 
sessions. A normal shutdown is the default. 


IMMED causes the NetView operator station, NetView to NetView, and hard- 
copy tasks to end immediately and then proceeds as if CLOSE NORMAL 
has been issued. Operators receive no warning messages. You can 
enter this command even while a normal close is still going on. 


DUMP causes the NetView program main task to end immediately and to 
take adump. The NetView operators receive no warning messages. 
You can enter and run this command even while a normal close is 
still going on. 


Usage Note 


If you use the CLOSE NORMAL command, every OST and NNT must be logged off before 
NetView can end. If NetView does not stop after you have entered the CLOSE 
command, you can use the system REPLY command to issue the CLOSE IMMED or 
CLOSE DUMP Command, which causes an immediate abnormal end. Do not, 
however, issue the CLOSE NORMAL Command again. 


Warning: CLOSE ends all NetView activity including system automation and 
network control. 


lf you use either the CLOSE IMMED or the CLOSE DUMP Command and have an optional 
task that has an ESTAE coded, then that task cannot post any other subtask or issue 
any macros that post while the CLOSE IMMED or CLOSE DUMP is processing. 


Example 


To end the NetView session normally, enter: 

MSG PPT 

This command tells the system that you want to enter a command. 
@xx DSI8G7A NCCF READY FOR COMMUNICATIONS 
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Then enter: 
xx CLOSE 


where xx is the number from message DSI807A. 


NetView ends when all operators and incoming cross-domain operators have 
logged off their terminals. 
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CLSTRS 


The CLSTRS CLIST displays the status of all cluster controllers (type 1 and type 2 
physical units) and their respective major nodes. 


The format of the CLSTRS CLIST is: 


cLstRS = [Act|Inact]ALL] 


where: 


Act displays information about all the active physical units. 


Inact displays information about all inactive physical units. 


ALL displays information about all physical units, regardless of their status. 


Usage Note 
This CLIST generates the following VTAM command: 
PISeLAY ELSTRS 


For more information on this command, see VTAM Operation. 
Example 


To display all the inactive physical units for your domain, type: 


a a Sa ~~ 
foe tee eS 
\ ee ee 


Response 


if the CLSTRS request is successful, the system responds with the following mes- 


sages: 


iST35Q1 VTAM DISPLAY - DUMAIN TYPE = CLUSTERS / PHY 

ISTG691 NCT472P TYPE = PU T4/5 MAJ NODE , ACTI 

[STG891I DW3270 TYPE = PHYSICAL UNIT » NEVAC 
[STO89T DW3275 TYPE = PHYSICAL UNET » NEVAC 
ISTSI4T END 


Brad! ae 
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DATE 


The DATE CLIST displays the current time and date. 


The format of the DATE CLIST is: 


Usage Note 


The format of the output is mm/dd/yy, where mm is the month,.dd is the day, and 
yy is the year. The time is hh:mm where hh is the hour (00-24) and mm is the 
minutes (00-60). 
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DEFAULTS 


The DEFAULTS command sets system-wide defaults for the logging and display of 
messages, and determines how the HOLD and BEEP actions are interpreted in the 


message automation table. 


The format of the DEFAULTS Command is: 


DEFAULTS [HOLD={ENABLE|DISABLE}] 
[BEEP = {ENABLE|DISABLE}] 


[SYSLOG ={YES|NO}] 
[NETLOG ={YES|NO}] 
[HCYLOG = {YES|NO}] 
[DISPLAY = {YES|NO}] 


where: 


HOLD ={ENABLE|DISABLE} Defines whether or not the HOLD action is to be taken 


BEEP = {ENABLE|DISABLE} 


SYSLOG = {YES|NO} 


NETLOG = {YES|NO} 


HCYLOG = {YES|NO} 


DISPLAY = {YES|NO} 


Usage Note 


from the message automation table. 


Defines whether or not the BEEP action is to be taken 
from the message automation table. 


Defines whether or not all messages are written to 
the system log. 


Defines whether or not all messages are written to 
the network log. 


Defines whether or not all messages are written to 
the hard-copy log if an operator has one active. 


Defines whether or not all message are displayed 
on NetView terminals. 


The DEFAULTS command can be overridden for a specific operator iD using the OVER- 
RIDE command (see “OVERRIDE” on page 3-126). 


The NetView provided actions (when you do not use DEFAULTS) are: 
BEEP=ENABLE ,SYSLOG=NO,NETLOG=YES ,HCYLOG=YES , DISPLAY=YES 


DISPLAY =NO Suppresses all messages unless they are identified in the message 
automation table with DISPLAY = YES. 


No messages are produced if this command runs correctly. 


Scope checking can be done on the DEFAULTS command. 
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DELAY 


The DELAY CLIST tells the system to wait for a specified amount of time and then, if a 
command is specified, send it to the system. | 


The format of the DELAY CLIST is: 


where: 


time is the time interval after which the command is run. If a command is 
specified, time must be the first operand and specified in 
hours:minutes form. The maximum time interval is 24:00 (every 24 
hours) and the minimum interval is 00:01 (every minute). Ifa 
command is not specified, the time must be in seconds. If needed, 
leading zeros must be included. 


command  Thename of the command or CLIST that you will be sending to the 
system. The command or CLIST will run under the PPT if a command is 
specified. 


Usage Note 


The DELAY CLIST invokes the EVERY command, which assigns a timer !D to the oper- 
ator ID that issued the DELAY CLIST. If more than one operator issues a DELAY CLIST, 
each operator could be assigned an identical timer ID. If this happens, the first 
operator to be assigned the timer ID will be scheduled, but the remaining one(s) 
will not be scheduled. Instead, a message will be issued saying that no command 
will be scheduled. 


Examples 


To wait for 3 hours and then start the system, enter: 
DELAY 03:00,STARTCNM 


To delay the next command that is entered for 5 seconds before sending it to the 
system, enter: 


DELAY 05 
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DELAY2 


The DELAY2 CLIST issues a command and purges the timer. DELAY2 can be used to 
undo an AT or EVERY command. DELAY2 is used when the timer was set with the PPT 
option. 


The format of the DELAY2 CLIST is: 


command | 


where: 
timerid is the identifier that you specified on a timer command (AT or EVERY). 


command __ is the name of the command or CLIST that the system is to run. 
Example 


If you already issued this AT command: 
AT 15:00,PPT,ID=DISP,MAJNODES 


You could prevent the command from being sent to the system at 15:00 and send it 
immediately to the system by entering: | 


DELAYZ DISP,MAJNODES 
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DIS 


The DIS CLIST displays the status of system resources. 


The format of the DiS COMMAND is: 


where: 


resname specifies the name of the specific resource to be displayed. 
Usage Note 


For compatibility with the VTAM DISPLAY command, you can preface the following 
CLISTs with the DiS CLIST (See also “DIS” on page 6-13): 


© APPLS - See page 3-10 

® BFRUSE - see page 3-27 

® CDRMS - see page 3-44 

® CDRSCS - see page 3-45 

® CLSTRS - see page 3-51 

® DROUTE - see page 3-65 

¢ LINES - see page 3-91 

® MAJNODES - see page 3-110 
® NCPSTOR - see page 3-121 
¢ PATHS - see page 3-127 

¢ PENDING - see page 3-128 
® STATIONS - see page 3-160 
e TERMS - See page 3-170 

© TSOUSER - see page 3-177. 


DIS TSOUSER runs under MVS only. 
Example 


To display the pending nodes, enter: 

DIS PENDING 

To display the status of node Ncp21, use the following command: 
DIS NCP21 
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uvs DISCONID 


The DISCONID command displays Mvs console IDs used by NetView. 


The format of the DISCONID command is: 


DISCONID 
Usage Note 


If an asterisk is displayed next to the console ID, this implies that the console ID has 
been assigned to the AUTOTASK by the user. 
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DISG 


The DISG CLIST displays resource status and connectivity information for LUs, Pus, 
lines, NCPS, and major nodes. 


The format of the DiISG CLIST is: 


where: 

resname specifies the resource for which status and connectivity informa- 
tion are to be displayed. 

ALL specifies that information is to be displayed for this resource 
and each higher resource. This is the default. 

ONLY specifies that information is to be displayed for this resource 
only. 

Usage Note 


The DISG CLIST cannot _run under the PPT. 

The DISG CLIST should not be used on line groups or on a token-ring. In line groups, 
DISG CLIST would only read the first line of the group. In a token-ring, DISG CLIST 
would recognize only the host and the ncp, but no lines under a token-ring. 


CAUTION: | 
incorrect results may occur when running the DISG CLIST while MSGMOD is on. 


Example 


To display resource status for A01A441 and higher resources, enter: 
DISG AO1A441 
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Response 


A panel similar to the following is displayed: 


CNVMOLNL1 © «~-VTAM DISPLAY : LOCAL NON-SNA LOGICAL UNIT. 
suerte a cece ae | - i = : - es ae | pe 
[ocsHOSho@ ble 2s hfe * tame Be, | | 
| ISTPUS | -----~-~---------441---------- eone---n------ | 


-$10= 00000225 a wai 
1/O TRC= OFF =. ~——sONETI.D= NETA 
BUF TRC= OFF i. 

SUBAREA= 001 _ 
IRN TRC= OFF 


NAME STATUS SESSION ID. —s SEND RECV VRN TP NETID 
'NCFO1000 ACTIV-PRI 00800001497D023D 0046 000A 0 0 NETA 


Action===> — ao : we mor Ga 
_ PFi= Help PF2= End PFS= Return 
— PF6= Roll = PF7= Backward : 


Figure 3-3. Resource Status and Connectivity Information 


To return to line-mode, press PF2. 


ser rs te st fo cms + 

~ LU | 
AQ1A441_—s| 
en ae ee + 


-- DESTRED= ACTIV 


1/0 TRC= OFF 


BUF TRC= OFF 


CNTLPLU= 

PLU= INHIBITED 
SLU= ENABLED 
DEVTYPE= LUO1) 


SESSIONS: 

LIM= 00000001 

ACTIV= 00001 
REQS= 00000 
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DISPCMD 


The DISPCMD command displays a list of the outstanding NPS commands. 


The format of the DISPCMD command is: 


where: 

ALL displays all outstanding network product support (NPS) com- 
mands. ALL is the default. 

iID=resname specifies the network name of a device. It displays all com- 
mands that are to be sent, or have been sent, to the specified 
device. | 

OP = operid specifies an operator iD. This operand displays outstanding 
(NPS) commands for that operator. If oOP="’ is specified, the 
commands for the issuing operator are displayed. 

PPT displays all outstanding NPS commands under the PPT. 

SP =spname specifies the network name of a service point. 

Usage Note 


lf you issue the DISPCMD command without any operands, the system displays all 
outstanding commands for the issuing operator. | 


Scope checking is done on the DisPCMD command and on the ALL, ID, OP, and sP 
operands. 


Example 


To display a list of all outstanding messages for device NY3710, type: 


DISPCMD ID=NY3710 
Response 


When the command completes successfully, the system responds as follows: 


DSI271I COMMAND OPERATOR ID/SP TAG 

DS12721 cmd1 operidl nodel tagl 
DSI2721 cmd2 operid2 node2 tag2 
DS1273] END OF OUTSTANDING COMMANDS DISPLAY 


where cmd is the name of the command as entered by the operator, operid is the 
name of the operator who issued the command, node is the network name of the 
device to which the command has been sent (or will go), and tag is the numeric 
identifier for the command (this value can be used with the TAG operand on the 
CANCMD). NetView displays the commands in the order the operator enters them. 


Note: The total number of commands displayed is limited by the number of solic- 
ited DSRBs available to the DsiaDs subtask. This value is set according to the 
DSRBO operand in DSICPINT (CNMS1006) initialization member. 


3-60 NetView Operation 


DISPCNFG 


The DISPCNFG Command displays a 3710 configuration. You can display the com- 
plete configuration or a single element of the configuration. 


The format of the DISPCNFG Command is: 


DISPCNFG §=ID= =resname : 
: — Gael, Re LINE = resnamel,A ADAPTER = resname| 


7 ear 


where: 
iD=resname 


ALL 
PRODUCT 


LINE = resname 


STATION = hse agi DISPLAY = a eenanne! aes 


is the name of the 3710. 


specifies the network names and device types for all ele- 
ments in the specified 3710 configuration. 


specifies the network name and type of the 3710 specified in 
the ID operand. PRODUCT is the default. 


specifies the network name and type of the specified line. 
You must specify the network name for LINE. 


ADAPTER = resname specifies the 3710 name and type of adapter and configura- 


STATION =resname 


DISPLAY = resname 


VERIFY 


DUMP 


Usage Note 


tion data specific to the named feature. You must specify the 
name for the 8 Port Line Adapter installed on a 3710. 


specifies the network name and type of the specified station. 
You must specify the network name for STATION. This operand 
can also be used to display data about a Pu attached to an 8 
Port Line Adapter by using the adapter’s network name. 


specifies the resource name and type of the specified BSC 3270 
display. This operand can also be used to display data about 
an LU associated with an 8 Port Line Adapter by using the 
adapter’s resource name. 


can be used only in a CLisT. It is intended for use by ssps 
Configuration Control Program (CCP) CLisTs that need to 
retrieve product data for use in performing dynamic reconfig- 
uration application sequence verification. 


dumps the record for the selected product, line, station, or 
display element. The DumP operand is ignored if the ALL 
operand is specified. 


The DISPCNFG command can be scope checked. 


Example 


To display the configuration for LINE2 on device NY3710, type: 
DISPCNFG ID=NY3710,LINE=LINE2 
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DISPFK 


The DISPFK CLIST displays the PF key settings for any component of NetView from 
which you entered this CLIST. 


The format of the DISPFK CLIST is: 


Usage Note 
The DISPFK CLIST cannot run under the PPT. 
Example 


lf you are in the command facility, enter: 
DISPFK 


to display your PF key settings for the command facility (NCCF) Component. 
Response 


The following is an example of how the PF key settings are displayed: 
C CNM11 PF KEY SETTINGS FOR NCCF COMPONENT ....... 


' CNM11 
DSI606I DISPLAY OF PF/PA KEY SETTINGS 
DSI607I KEY ----TYPE----  ---------- COMMAND---------- 


DST615I PAZ CANNOT BE SET PREDEFINED FOR MOD = DSIHWP 
DST6161 PA3 NOT SET YET 

DST608I PF1 IMMED,APPEND PFHELP 
DSI608I PF2 IMMED,IGNORE PFEND 
DST608I PF3  IMMED,IGNORE PFRETURN 
DSI608I PF4 IMMED,IGNORE PFTOP 
DST6081 PF5 IMMED,IGNORE  PFBOTTOM 
DS1608I PF6 IMMED,IGNORE ROLL 
DST6081 PF7 IMMED,IGNORE PFBACK 
DST608I PF8 IMMED,IGNORE PFFORW 
DS1608I PF9 IMMED,IGNORE  PFCOPY 
DST6081 PF10 IMMED,IGNORE DISPFK 
DST6081 PF11 IMMED,IGNORE HOLD 
DST6081 PF12 IMMED,IGNORE RETRIEVE 


DST6091 END OF PF/PA KEY DISPLAY 


Here’s what the operands mean: 


APPEND tells the system to append the data in the input field to the end of the 
command text when you press the PF key. 


DELAY tells the system to write the command to the input area and place the 
7 cursor after the last character of the command. You can then modify 
the command before you press ENTER. 
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IGNORE tells the system to ignore data in the input area. 


IMMED tells the system to process this command immediately. 


The message CANNOT BE SET (under heading TYPE) indicates that the PF key cannot 
be set to another command by using the SET command. 


You can customize this CList. See the NetView Command Lists for more informa- 
tion. 
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DRDS 


The DRDS CLIST reconfigures an NCP dynamically. 


The format of the DRDS CLIST is: 


where: | 

resname is the name of a member in a data set or the name of a cos file con- 
taining the dynamic reconfiguration (DR) statements. 

Usage Note 


This CLIST generates the following VTAM command: 
VARY DRDS 


Resources that are dynamically reconfigured will not be known to the status 
monitor. For more information on this command, see VTAM Operation. 


Note: The use of this command is incompatible with use of the status monitor. 
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DROUTE 


The DROUTE CLIST displays the status of explicit routes and virtual routes ina 
domain. 


The format of the DROUTE command is: 


DROUTE subareat 3 | 
[,cOS = cosname|,ER= n|,ER=ALL|,VR=n] 
[YES|No] Peek 
. [,ORIGIN = Subarea2] 
[LNET=netid]) | 


where: 


subareal is the subarea address of the destination subarea of the 
routes to be displayed. 


COS =cosname is the class of service name. If this operand is specified, all 
virtual routes to the specified destination subarea within this 
class of service are displayed. 


ER=n is an explicit route number (0-7). If this operand is speci- 
fied, all the explicit routes identified by this explicit route 
number that are known to vTAM to the specified destination 
subarea are displayed. 


ER=ALL displays every explicit route to the specified destination 
subarea. This is the default. 


VR=n is a virtual route number (0-7). If this operand is specified, 
the virtual routes identified by this virtual route number to 
the specified destination subarea are displayed. 


YES specifies that an explicit route test is to be performed for 
each explicit route contained in the requested display. 


NO specifies that the requested route status is to be displayed, 
but that no explicit route test is to be performed. This is the 
default. 


ORIGIN = subarea2 specifies the name of the subarea Pu where the route starts. 
NET = netid specifies the network attached to the origin node that con- 
tains the routes. 


Usage Note 


This command generates the following VTAM command: 
DISPLAY ROUTE 


For more information on this command, see VTAM Operation. 
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Example 


To display the explicit route number 1 to subarea 20 without doing an explicit route 
test, use the following command: | 


DROUTE 20,ER=1,ORIGIN=NCP1 


Response 


If the DROUTE request is successful, you receive a response similar to: 


IST5351 
IST8081 
IST5361 
IST5371 
[ST5371 
IST5371 
IST314] 


ROUTE DISPLAY 3 FROM SA 10 TO SA 20 


ORIGIN PU = NCP1 DEST PU = NCP2 


VR TP 
5 0 
a ot 
5 2 

END 


STATUS — ER ADJSUB 
INACT ] 20 
INACT ] 20 
TNACT 1 20 


STATUS 
INOP 
INOP 
INOP 


In this example, vR is the virtual route number, and TP is the transmission priority, 
the status is inactive, ER is the explicit route number, ADJSUB is the adjacent 
subarea number with a status of inoperative. 
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DSISAPDR 


The DSISAPDR CLIST changes the service adapter password for a 3710. 


The format of the DSISAPDR CLIST is: 


DSISAPDR resname 


where: 


name_ is the network name of the 3710 containing the PC element field to be 
changed. 


Usage Note 

You must enter the password into the CLIST using an editor. The password must be 
from six to eight alphanumeric characters. The first character of the password 
must be alphabetic or @, #, or $. 


Example 


To change the password for NYC3710, edit the CLIST to change the password. Then 
issue the command: 


DSISAPURK NYUS/ iO 
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ENDSESS 


The ENDSESS command ends specific subsystem sessions. 


The format of the ENDSESS command is: 


where: 

OPCTL ends the operator-contro! sessions. 

FLSCN ends the full-screen sessions. 

ALL specifies that all OPCTL or FLSCN sessions that you started 


are to end. 


SESSID=sessionid specifies the unique session identifier for operator-control 
sessions. 


APPLID= applid specifies the logical unit name of the destination subsystem 
with which an active session exists and is to end. 


Usage Note 


APPLID applies to all SESSIDS with this APPLID. If you need to stop only a single 
session for this APPLID, use the SESSID operand instead of APPLID. 


Example 


To end a TSO session for an application program named RALTSO, type: 
ENDSESS FLSCN,APPLID=RALTSO 


Response 


After you enter ENDSESS, you should get this message: 
DSI4951I FLSCN SESSION(S) FOR APPLID=RALTSO ENDING 


If the session ends successfully, you will get this message: 


DST496I_ FLSCN SESSION BETWEEN APPLID=RALTSO 
AND SRCLU=NCF11 ENDED 
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ERST 


The ERST CLIST displays the meaning of the explicit route status code. 


The format of the ERST CLIST is: 
ERST status 


where: 


status specifies the explicit route status code that you want explained. 
Usage Note 


This command is not allowed if NetView is installed with the DASD Conservation 
Option. (See “DASD Conservation Option” on page 2-8.) 


Example 


To display the meaning of the explicit route status INACT, type: 
ERST INACT 


Response 


You will see the following panel displayed: 


“The ER is defined to VTAM in. a 1 poth. definition set and: 
| ‘physical ly avoi lable. to. the network - 


ae Hide: Gaver Been, elleceeatutiy. ‘activated: “Activation will ‘be 
ee aaa alae the ER is , needed, for. a session. 2 


Figure 3-4. Example of Status Code Description 
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ESESS 


The ESESS CLIST ends subsystem sessions. 


The format of the ESESS CLIST is: 


ALL ends all subsystem sessions. 

FLSCN ends one or all subsystem sessions in full-screen mode. 

applid is the application identifier of a specific full-screen session to be ended. 
OPCTL ~~ ends one or all subsystem sessions in operator control mode. 


sessid specifies the specific operator control subsystem session to be ended. 


Usage Note 


This CLIST generates an ENDSESS command. See “ENDSESS” on page 3-68 for 
more information. 


Example 


To stop all subsystem sessions, type: 
ESESS ALL 
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EVERY 


The EVERY command schedules a command to be run repetitively at intervals. 


The format of the EVERY command is: 


EVERY time 


LPPT]) 
_ Lid=resname] 
command 
where: 
time is the time interval after which the command is run. It must be the 
first operand and specified in hours:minutes form. The maximum 
time interval is 24:00 (every 24 hours) and the minimum interval is 
00:01 (every minute). 
PPT specifies that the command or CLisT indicated by the command is to 


run under the PPT. If PPT is specified, the command will run whether 
or not you are logged on at the indicated time. If PPT is not coded, the 
command will run only if you are logged on at the indicated time. The 


following commands cannot be run under the PPT: AGAIN, AUTOWRAP, 
BGNSESS FLSCN, CANCEL, CLEAR, CLOSE, DISG, ENDSESS, GO, HALT, INPUT, 
LINKDATA, LINKTEST, LIST, MDMCNFG, MDMCNTL, MOVE, REPLY, RESET, RETRIEVE, 
RETURN, ROLL, ROUTE, RTRNSESS, SET, STACK, START, STARTDOM, SWITCH, 


UNSTACK. 


ID=resname is the unique one- to eight-character identifier that you defined for 
this timer request. The resname cannot be ALL and cannot begin with 
the characters sys. This operand is optional. 


command _ indicates the “regular” or “both” command or command list to run. 
You must specify command and it must be the last operand. 


Usage Note 


Commands defined as “regular” or “both” when NetView was installed may be 
used with EVERY. Commands defined as “immediate” cannot be used with EVERY. 


The command runs at the indicated interval until the EVERY command is purged. 


Be sure that scope-checking for the PPT operand is defined. 


Note: To avoid overloading system resources, avoid excessive number of com- 
mands with short time intervals. To do so, you should keep commands to 25 
or less. 
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Example 


To list your operator ID every 3 minutes with a timer ID of OP21TMP, type: 
EVERY 3, ID=OP21TMR LIST OP7 


You can also list your operator ID every 3 minutes even if you are not logged on. 
To do this, use the following command: 


EVERY 3, PPT LIST OP7 
Response 


You will see the following messages on your screen if the EVERY command runs 
successfully. 


DS10341 COMMAND SCHEDULED BY AT/EVERY COMMAND - LIST OP7 
DSI201I TIMER REQUEST SCHEDULED FOR EXECUTION ID=OP21TMP 


EXCMD 


The EXCMD command queues a NetView command or CLIST to another task to be 
executed. 


The format of the EXCMD command is: 


EXCMD opid cmd operands 


where: 

opid specifies any operator ID. This is a required field and can be 
scope-checked. 

cmd specifies any valid NetView command or CLIsT. This is a 
keyword field and can be scope-checked. 

operands specifies optional operands. 

Usage Note 


The opid and cmd are scope checked by the command processor. 


Make sure the specified command or CLIST can be run in the environment provided 
by the destination task, or unpredictable results may occur. 


Examples 


To queue the MSG command to be executed on NETOP1 task, enter: 
EXCMD NETOP1 MSG OPER Please monitor CNO/ 


To queue the LIST command to be executed on the PPT task, enter: 
EXCMD PPT LIST STATUS=TASK 
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FTRACE 


The FTRACE CLIST starts, modifies, or stops VTAM traces. 


The format of the FTRACE CLIST is: 


where 

TG specifies an NCP transmission group trace for the transmission groups 
containing the ncP lines specified. 

LINE specifies an NCP line trace for the lines specified. 

{@) specifies tracing of input/output (1/0) activity associated with the 
nodes specified. 

BUF specifies the tracing of text that passes through vTAM buffers on the 
way to or from the nodes specified. 

EVERY specifies that /O and BUF traces are to be done. 

VTAM specifies a VTAM internal trace for the APi, Plu, SMS, and SSCP Compo- 
nents. 

ON starts the specified trace or modifies parameters for online trace. 

OFF stops the specified trace. 

resname is the name of the resource for which tracing is to be done. At least 
one must be specified unless VTAM was specified. 

Usage Note 


This CLIST generates one of the following VTAM commands: 
MODIFY TRACE 


MODIFY NOTRACE 


When tracing terminals that are logging on to NetView, all the data passed to or 
from the terminal is traced including passwords. 


For more information on these commands, see VTAM Operation. 
Example 


To start a VTAM internal trace, use the following: 
FTRACE VTAM 
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GENALERT 


The GENALERT command is used to generate an alert which can be processed by the 
hardware monitor. This alert can be recorded in the hardware monitor data base, 
viewed on the Alert Dynamic screen, and available for all hardware monitor proc- 
essing, depending on the hardware monitor SRFILTER setting. The task DSICRTR must 
be active in order to route alerts. The GENALERT command can be used in conjunc- 


tion with message BNJ146! to forward alerts to a central host. The text of this 
message contains the necessary operands for GENALERT as described below. 


The GENALERT command has three formats: generic, non-generic, and RECFMS. The 
format of the generic GENALERT command is: 


| GENALERT G ITYPE= oo! ALID= = XXXXXXXX DESC = XXXX 
-PRID= = XXXXXXXXX PC= = XXXX, XXXX, XXXX sg 

ACTS = XXXX, . . bone 
_USER= XXXX, .. 
FAIL = XXXX, .. 


"XXX: XXXX, . XXXX 
« XXXXIXXXX, . XXXX” 
INST = XXXX, ... .XXXX;XXXX, . XXX 
— [TEXT= XXXXXXXX.. XXXX'] ees se 
_ HIER = XXXXXXXX,XXXX, XXXXXXXK, XXXX, 20000000, XXXK, 


XO, XXXX AXXXAXXX, XXXX cy 


specifies the generic NMVT alert format 


specifies an alert type (valid values: PERM, TEMP, PERF, INTV, CUST, 
USER, AVAL, NTFY, ENVR, INST, PROC, SCUR, DLRC, PAFF, SNA, IMPD, HELD, 


UNKN, IMR) The default is NTFY. 

specifies an alert ID 

specifies an alert description 

specifies a product set ID 

specifies a probable cause (maximum of 3 characters) 
specifies actions 

specifies user cause; action 

specifies failure cause; action 


specifies install cause; action 


specifies product unique text (maximum of 140 characters) 


specifies hierarchy (maximum of 8 characters) names and types 


(maximum of 4 characters) 


For each name specified (maximum of 5 pairs) a matching type 


must be input. 
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The format of the non-generic GENALERT command is: 


where 

N specifies the non-generic NMVT alert format 

TYPE specifies an alert type (valid values: PERM, TEMP, PERF, INTV, CUST, 
USER, AVAL, NTFY, ENVR, INST, PROC, SCUR, DLRC, PAFF, SNA, IMPD, HELD, 
UNKN, IMR) The default is NTFY. 

PRID specifies a product set ID 

MAJ specifies a major cause 

MIN specifies a minor cause 

ACT specifies an action code 

QUAL specifies product-unique qualifiers (maximum of 3) 

TEXT specifies product unique text (maximum of 140 characters) 

HIER specifies hierarchy names and types (maximum of 5 pairs) 


The format of the GENALERT command with RECFMS support is: 


where: 

TYPE specifies alert type (valid values: PERM, TEMP, PERF, INTV, CUST, 
AVAL, NTFY, USER, ENV, INST, CRDC, SCUR, DLRC, PAFF, SNA, IMR) The 
default is NTFY. 

R specifies the RECFMS alert format 

BKID specifies a block ID 

ACT specifies an action code 

MIN specifies a minor cause 

MAJ specifies a major cause 

TEXT specifies product unique text (maximum of 140 characters) 

HIER specifies hierarchy names and types (maximum of 5 pairs) 

QUAL specifies product unique qualifiers (maximum of 3) 
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Usage Note 


The format operand (G,N or R) is the only positional parameter. It must follow the 
command name (GENALERT). Values cannot be enclosed in parenthesis. Multiple 
values must be separated by a comma and the last value specified must be fol- 
lowed by a blank. Product-unique text must be enclosed in quotes. 


When you issue GENALERT with the first level hierarchy type of dom, only alerts will 
be logged on the NPDA database depending on the srr filters and the events logging 
will be suppressed. 


You must specify either ACTS or one or more cause/action pairs in the generic 
format of the GENALERT command. Actions must follow causes and must be sepa- 
rated by a semi-colon (;). If you specify ACTS, you cannot specify USER, FAIL, Or INST. 
ACTS implies CAUSE UNDETERMINED. 


The 82 subfield (SF), Detailed Data, and the 83 sF, product set identifier, for subvec- 
tors 94, 95, 96, and 97 cannot be specified with GENALERT. Therefore, code point 
table BNJ82UTB is not accessed. 


Since PsiD is not supported through GENALERT, the $ insert character in the code 
point tables will always be replaced by a blank when the text is displayed (the $ is 
normally replaced with the PsiD value). 


The ALID value is supposed to be a unique value that is determined by following the 
algorithm in the architecture (based on the values in the TYPE, DESC, USER, FAIL, and 
INSTALL fields). 


Example 


The following command will generate a non-generic NMVT to be logged to the hard- 
ware monitor data base. 


GENALERT N TYPE=PERM PRID=USER1 MAJ=09 MIN=11 ACT=12 
QUAL=QUAL1 TEXT='PRODUCT UNIQUE TEXT’ 
HIER RESNAME1,TYP1,RESNAME2, TYP2,RESNAME3, TYP3 
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GO 


The GO command allows you to resume running a CLisT that is in PAUSE status or 
WAIT status. You can also use the GO command to give values to a CLIST that is in 
PAUSE Status. 


The format of the GO command is: 


where: 


operand is an operand or a group of operands that that you can pass to a sus- 
pended CLIST if the CLIST requested data. 


Usage Note 

The GO command is both a regular and an immediate command. 

The operand field can be any character other than a comma or blank. A comma or 
blank means the end of an operand. Single quotation marks are not allowed within 
operands. Text within single quotation marks is treated as a single operand. Two 
commas in a row indicate a null operand. All operands are positional. 

NetView rejects the GO command if a stack command has been entered. The CLIST 
with the &waliT has been suspended. The w remains on the screen as a reminder 
that the waiting CLIST is still intercepting messages. 


Example 


If you have a P in the top right hand corner of your screen and you want to resume 
running a CLIST, enter: 


GO 


The CLIST resumes running. 
Response 


If the GO command is successful, the P or w in the upper right corner of your screen 
disappears. The CLIST resumes running. No message appears. 
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HELP 


The HELP CLIST displays help information for the NetView components and com- 


mands. 


The format of the HELP CLIST is: 


Help 


NETVIEW 


displays information on NetView. 
displays information on VTAM. 
displays a list of commands and CLISTs. 


displays information on the 4700 support facility. This operand 
can be used in MVS and VSE. 


displays information on the hardware monitor. 

displays information on component screens. 

displays information on the command facility. 

displays information on the terminal access facility. 
displays information on the session monitor. 

displays information on the Network Performance Monitor. 


displays information on the status monitor. 


VTAM 
[, COMMANDS] 
TARA 
[ COMMANDS] 
~ NPDA 
[, COMMANDS] 
_ NCCF | | 
[, COMMANDS|,SCREENS] 
TAF 
[,COMMANDS|,SCREENS] 
NLDOM — 
[,COMMANDS|,SCREENS] 
NPM 
STATMON | 
[,COMMANDS|,SCREENS] 
COMMANDS | 
commandname 
where: 
NETVIEW 
VTAM 
COMMANDS 
TARA 
NPDA 
SCREENS 
NCCF 
TAF 
NLDM 
NPM 
STATMON 
commandname 


displays information on a specific command or CLIST. 


Use a comma or a blank as a delimiter between operands. 
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Usage Note 


If you enter Help from a component and specify no operand, help information for 
that component appears. 


When you use this CLIST, the Help facility remains on the NetView component stack 
that is used with ROLL until the component is ended. However, if you enter the ERST, 
VRST, STATUS, OR RCFB CLISTS, you will return to the component from which you 
reached help. 


This command is not allowed if NetView is installed with the DASD Conservation 
Option. (See “DASD Conservation Option” on page 2-8.) 


Example 


To receive help for the command facility (NCCF) commands, enter: 


Help NCCF,COMMANDS 
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HELPDESK 


The HELPDESK CLIST provides information to help you determine a user’s problem. 
Techniques for problem determination are explained. 


The format of the HELPDESK CLIST is: 


HelpDesk 


Usage Note 


When you use this CLIST, the HELPDESK component remains on the NetView compo- 
nent stack that is used with ROLL until the component is ended. 


HELPDESK can be abbreviated as HD. 


This command is not allowed if NetView is installed with the DASD Conservation 
Option. (See “DASD Conservation Option” on page 2-8.) 


Example 


To access help desk information, enter: 


MET] DPE S te 
Response 


The response is as follows: 


| cen -NETVIEW HELP DESK 
“Select “7 * Fo get information about | 
| qT A terminal not working | 
ao A transaction or an application not working 
oe . Slow response time 
4 Problems identified through network monitoring 


- System message cross- reference 


Type a a number a through 5), then press. ENTER. 
oe Reconmendat ions. for ale Setup « ond Use of the help desk. 


ve oo MBL NET VLEW S Netview Help. Menu 


Figure 3-5. Help Desk Panel 
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HEXDEC 


The HEXDEC CLIST displays the decimal equivalent of a hexadecimal number. This 
CLIST can also be called from another CLisT either to execute a command with the 
hexadecimal equivalent of a decimal number as its operand or to return the 
hexadecimal value as a return code to the calling CLIST. 


The format of the HEXDEC CLIST is: 


where: 

hexnumber is the hexadecimal number to be converted, up to four charac- 
ters long. 

command if specified, is a command with its operands (up to seven) that is 
to be issued. The decimal number is also passed to the CLIST or 
command after the last operand. 

EXIT if specified, causes the decimal value to be returned as a return 
code. 

Example 


To convert the hexadecimal number 44 to a decimal value, type: 
HEXDEC 44 


Response 


The response is as follows: 
C NCFO1 CNM324I HEXDEC: X'0044' = 68 
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HOLD 


The HOLD command prevents the screen from locking until you unlock it. 


The format of the HOLD command is: 


HOLD 


Usage Note 

Initially, the HOLD Key is PF11. The DISPFK command allows you to display the 
current PF key settings. (Ask your lead operator whether your default PF key set- 
tings are established.) 


With a HOLD key you can keep the present screen, without having it unlock automat- 
ically, and still remain in AUTOWRAP mode. 


The HOLD key freezes the screen. You can use it if you notice something that you 
need time to read before it is erased. You can also use it to freeze the screen 
while you mark messages for deletion or enter a command. 

Example 

To hold a screen, press PF11. 


Response 


The following message appears at the bottom of your screen: 
DS1662I SCREEN HELD 


To stop holding the screen, press the ENTER or CLEAR key. 
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IMR 


The IMR CLIST starts or stops intensive mode recording for a link station or physical 
unit. This CLIsT can assist in problem determination. 


The format of the IMR CLIST is: 


where: 
station specifies the name of the link station or physical unit. 


ACT specifies that intensive mode recording should be started for the named 
station. 


INACT specifies that IMR should be stopped for the named station. 


n specifies the maximum number of temporary errors that are to be 
_recorded for the named station. The value can be from 1 to 65535. The 
default is 10. You cannot use this operand if you also specified the INACT 
operand. 


Usage Note 


This CLIST generates the following vVrAM command: 
MODIFY IMR 


For more information on this command, see VTAM Operation. 
Example 


To turn on intensive mode recording for STATION1 and record the first 20 temporary 
errors, use the following command: 


IMR STATION] ,ACT,20 
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INACT 


The INACT CLIST deactivates a VTAM resource. 


The format of the INACT CLIST is: 


INACT) id 
; : [tL,FI.R] YS 
~ GFINALY 
“Gacthinact) 
~~ -L,RMPO] oo ee ee 
where: 
id specifies the name of the major or minor node to deactivate. 


I specifies that the resource and applicable subordinate resources are to 
be deactivated immediately. 


F specifies that the resource and applicable subordinate resources are to 
undergo forced deactivation. 


R specifies that the resource and applicable subordinate resources are to 
undergo forced deactivation and subsequent reactivation. 


FINAL specifies that the physical unit is no longer required and that there are 
no immediate plans to reactivate it. 


ACT specifies that active cross-domain links and link stations are to remain 
active after the NCP major node is deactivated. 


INACT specifies that cross-domain links and link stations are to be deactivated 
as part of the NcP deactivation. 


RMPO applies to an NCP major node only and specifies that the communication 
controller in which the ncP is running is to be powered off automatically 
at the completion of the deactivation. 


Usage Note 


This CLIST generates the following VTAM command: 
VARY INACT 
For more information on this command, see VTAM Operation. 


Note: The FINAL and RMPO operands cannot be used together. 
Example 


To deactivate NcP1 but keep any active cross-domain links and link stations active, 
use the following command: 


TINACT NCP1 
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INACTF 


The INACTF CLIST deactivates a VTAM resource with a forced deactivation. Status 
monitor will not monitor any nodes that you inactivate using the INACTF CLIST. 


The format of the INACTF CLIST is: 


id specifies the name of the major or minor node to deactivate. 


FINAL specifies that the physical unit is no longer required and that there are 
no immediate plans to reactivate it. 


ACT specifies that active cross-domain links and link stations are to remain 
active after the NCP major node is deactivated. 


INACT specifies that cross-domain links and link stations are to be deactivated 
as part of the NcP deactivation. 


RMPO applies to an NCP major node only and specifies that the communication 
controller in which the ncpP is running is to be powered off automatically 
at the completion of the deactivation. 

Usage Note 


This CLIST generates the following VTAM command: 
VARY INACT,FORCE 


For more information on this command, see VIAM Operation. 
Note: The FINAL and RMPO operands cannot be used together. 
Example 


To force deactivation of NCP1 but keep active cross-domain links and link stations, 
use the following command: 


INACTF NCP1 
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INDEX 


The INDEX CLIST displays subjects that are discussed in the online help facility. 


The format of the INDEX CLIST is: 
INDEX {AIBI...1Z} 


Usage Note 


Use PF7 and prs to move backward and forward through the index. If you find an 
item that you would like to reference, enter the option (found next to the item) in 
the Action field. You can enter only one option at a time, even if multiple options 
are given. 


If you enter the index by using a particular letter, you cannot move to another letter 
without issuing the INDEX CLIST again. When you use this CLIST, the INDEX component 
remains on the NetView component stack that is used with ROLL until the compo- 
nent is ended. 


This command is not allowed if NetView is installed with the DASD Conservation 
Option. 


To display a list of subjects beginning with the letter s, enter: 
INDEX S 


Response 


The following screen is an example of what will appear: 


ince & : = “INDEX aaortt HELP PANELS 


Page 1 of 4. 
‘Select 5 pie es 
ess as 
4 
“session. trace. dete... 6 ai ble a ciate 5 
ens of: control. ie a ee ee ee ee . 6 
cs - ee 


ae ca PFS Bot tom. 


Figure 3-6. Sample Index Panel 
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To see the help information on setting up PF keys, enter 1 in the Action field. 
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INPUT 


The INPUT Command modifies the length of the command entry area of the line 
mode panel. The command entry area is at the bottom of the command facility 
display area. 


The format of the INPUT Command is: 
INPUT [123] 


Usage Note 

The length of the input area is limited to 240 characters. The input area can be 
changed to one, two, or three continuous 80-character input lines. The default is 
one. 

If the display area width is greater than 80 characters, the number of input lines is 
240 divided by the display width. The result is rounded up. The end of the input 
area is indicated by three less than symbols (< < <). Only the command facility 
will be affected. 


Commands retrieved from the hardware monitor or session monitor command line 
will be truncated to fit the command line. 


Example 


To change the command entry area to two lines, type: 
INPUT 2 


Response 


NetView erases the screen and increases or decreases the input area as specified. 
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IOPD 


The 10PD CLIST allows the operator to change the 1/0 problem determination time-out 
interval. 


The format of the |OPD CLIST is: 


where: 


interval specifies the time-out interval in seconds for the input/output (1/0) 
problem determination function. The range must be from 0 through 
5366000 seconds. 


Usage Note 


This cList generates the following VTAM command: 
MODIFY IOPD 


For more information on this command, see VTAM Operation. 
Example 


To change the /o problem determination time-out interval to 5 minutes (300 
seconds), use the following: 


TOPD 300 
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LINES 


The LINES CLIST displays the status of lines and channel links in the domain. 


The format of the LINES CLIST is: 


LINES Act 
ALL 
inact 

where: 


Act specifies that information is to be displayed about all active lines. 


ALL specifies that information is to be displayed about all lines within each 


major node regardless of their status. 


Inact specifies that information is to be displayed about all inactive lines. 
Usage Note 


This CLIST generates the following VTAM command: 
DISPLAY LINES 


For more information on this command, see VTAM Operation. 


Example 


To display the status of all active lines, type the following: 
LINES ACT 


Response 


You will receive a response similar to: 


IST3501 VIAM DISPLAY ~- DOMAIN TYPE = LINES 

TST3541 PU 74/5 MAJOR NODE = ISTPUS 

IST170I LINES: 

ISTOBOI O9C-L ACTIV----I O3F-L ACTIV----I O8F-L  ACTIV----I 
[ST2311 CA MAJOR NODE = H21C10 

ISTI760 LINES: 

TISTO8GI H21CC94 9 ACTIV----E 
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LINESTAT 


Use the LINESTAT command to control a 3710 line. 


The format of the LINESTAT command is: 


where: 

iID=resname is the network name of the 3710 to which the line is 
attached. 

PORT = portnumber is the 3710 port number of the line for which you want to 
display or change line status. The valid port numbers are 
1AA, 1BB, 1CC, 1DD, and so on, up to and including 16AA and 
16BB. 

LINE = resname is the network name of the line for which you want to 
change line status. 

HALF sets the line attached to the port to half speed. 

FULL sets the line attached to the port to full speed. 

SNBU specifies that the line or port is to be changed to a 
switched network backup line. 

NOSNBU specifies that the line or port is to be changed from a 
switched backup line to a normal line. 

SSL is used to notify a 3710 when you are reactivating a spe- 
cific secondary line. 

Usage Note 


With the LINESTAT command, you cannot set lines using start-stop transmission or 
X.25 protocols to: 


e Half speed 


e Switched network backup mode. 


For addresses 1 through 15, ports AA and DD are valid. For address 16, only ports 
AA and BB are valid. 


Scope checking can be done on the LINESTAT command. 
Example 


To change LINE1 on device NY3710 to full speed, type: 
LINESTAT ID=NY3710,LINE=LINE1, FULL 


3-92 NetView Operation 


LINKDATA 


- oe LuN= using node|,ENTRYLCC = =entry Lec] © 


The LINKDATA command requests a service point to return device data for a given 
link or link segment. 


The format of the LINKDATA command is: 


-LINKDATA — SP=service point name, — 


ey APPL = application name, | | 
LINE = line RESOURCE = resource name 


oe ae =remote 2 device einedo))e EXITLCC= ‘exit rec) tag So ee 


where: 

SP specifies the name of the service point to execute the 
command. 

APPL specifies the name of the link connection subsystem 
manager (LCSM) to execute the command. 

LINE identifies the linename of the link connection. 

RESOURCE identifies the name of link connection component within 
a link connection. 

UN identifies the name of the primary link station for an 
unbalanced mode link or either node that contains the 
link station of a balanced mode link. 

ENTRYLCC identifies the name of the first (entry) link connection 
component of a link connection. 

RD identifies the name of the secondary (adjacent) link 
station for an unbalanced mode link or the other node 
containing a link station of a balanced mode link. 

EXITLCC identifies the name of the last (exit) link connection 


component of a link connection. 
Usage Notes 


You can use the ENTRYLCC and EXITLCC operands to reduce the data received. This 
command can be issued from a CLIST to help automate problem determination and 
error recovery. If you issue the LINKDATA command from a CLIST, NetView returns 
the resulting data to the CLisT for its use. If LINKDATA is issued from a command 
line, the results are displayed on your terminal on one or more LINKDATA REPLY 
panels. (See NetView Command Lists for more information on how to use LINKPD in 
a CLIST.) 


Four sample CLISTs (INITCFB, ADDLINE, SPLOOKUP, FINDNCP) are provided with NetView 
to simplify the specification of the parameters for this command. Another CLIST 
(TEST SP) Shows an example of how to invoke this command and display the results. 
These five CLISTs are documented in the NetView Installation manual. 


Scope checking can be done on the LINKDATA command. 
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| Example 


To send a LINKDATA command to service point NMws1 to retrieve data on line LIN3, 
enter: 


LINKDATA SP=NMWS1 APPL=APPLO7 LINE=LIN3 


APPLO7 is the link connection subsystem manager (LCSM) that will execute the 
command. 
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LINKPD 


The LINKPD command requests a service point to do problem determination on a 
given link or link segment. 


The format of the LINKPD command is: 


LINKPD SP = service point name, 
APPL = application name, 
LINE = [ine name|RESOURCE = resource name 
[,UN= using node|,ENTRYLCC = entry LCC] 
[,RD = remote device (node)|,EXITLCC = exit LCC] 


where: 

SP specifies the name of the service point to execute the 
command. 

APPL specifies the name of the line connection subsystem 
manager (LCSM) to execute the command. 

LINE identifies the linename of the link connection. 

RESOURCE identifies the name of link connection component within 
a link connection. 

UN identifies the name of the primary link station for an 
unbalanced mode link or either node that contains the 
link station of a balanced mode link. 

ENTRYLCC identifies the name of the first (entry) link connection 
component of a link connection. 

RD | identifies the name of the secondary (adjacent) link 
station for an unbalanced mode link or the other node 
containing a link station of a balanced mode link. 

EXITLCC identifies the name of the last (exit) link connection 
component of a link connection. 

Usage Note 


You can use the ENTRYLCC and EXITLCC operands to reduce the data received. This 
command can be issued from a CLIST to help automate problem determination and 
error recovery. If you issue the LINKPD command from a CLIST, NetView returns the 
resulting data to the CLIST and to your terminal as a message or messages. (See 
NetView Command Lists for more information on how to use LINKPD in a CLIST.) 


Four sample CLISTs (INITCFB, ADDLINE, SPLOOKUP, FINDNCP) are provided with NetView 
to simplify the specification of the parameters for this command. Another CLISsT 
(TEST SP) shows an example of how to invoke this command and display the results. 
These five CLISTs are documented in the NetView Installation manual. 


Scope checking can be done on the LINKPD command. 
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Example 


To send a LINKPD command to service point (SP) NMWSs1 to do a problem analysis on 
line LIN3, enter: 


LINKPD SP=NMWS1 APPL=APPLO7 LINE=LIN3 


APPLO7 is the link connection subsystem manager that will execute the command. 
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LINKTEST 


The LINKTEST command requests a service point to test a given link or link segment. 


The format of the LINKTEST command is: 


LINKTEST SP=sSservice point name, 
- APPL=application name, _ 
LINE = [ine name|RESOURCE = resource name 
[,UN= using node|,ENTRYLCC=entry LCC] 
[,RD= remote device (node)|,EXITLCC = exit LCC] 
[,SELFCNT = number of repetitions] | 


where: 

SP specifies the name of the service point to execute the 
command. 

APPL specifies the name of the link connection subsystem 
manager (LCSM) to execute the command. 

LINE identifies the linename of the link connection. 

RESOURCE identifies the name of link connection component within 
a link connection. | 

UN identifies the name of the primary link station for an 
unbalanced mode link or either node that contains the 
link station of a balanced mode link. 

ENTRYLCC identifies the name of the first (entry) link connection 
component of a link connection. 

RD identifies the name of the secondary (adjacent) link 
station for an unbalanced mode link or the other node 
containing a link station of a balanced mode link. 

EXITLCC identifies the name of the last (exit) link connection 
component of a link connection. 

SELFCNT specifies the number of self test repetitions to be exe- 
cuted. The range is 1-255, with default = 1. 

Usage Note 


You can use the ENTRYLCC and EXxITLCC operands to reduce the data received. This 
command can be issued from a CLIST to help automate problem determination and 
error recovery. If you issue the LINKTEST command from a CLisT, NetView returns 
the resulting data to the CLIST for its use. If LINKTEST is issued from a command line, 
the results are displayed at your terminal on one or more LINKTEST REPLY panels. 
(See NetView Command Lists for more information on how to use LINKTEST ina 
CLIST.) 


Four sample CLIsTs (INITCFB, ADDLINE, SPLOOKUP, FINDNCP) are provided with NetView 
to simplify the specification of the parameters for this command. Another CLIST 
(TEST SP) shows an example of how to invoke this command and display the results. 
These five CLISTs are documented in the NetView Installation manual. 
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Scope checking can be done on the LINKTEST command. 
Example 


To send a LINKTEST command to service point NmMwsi to perform a test on line LIN3, 
enter: 


LINKTEST SP=NMWS1 APPL=APPLO7 LINE=LIN3 


APPLO7 is the link connection subsystem manager that will execute the command. 
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LIST 


The List command gives you information about your NetView session. 


The format of the List command is: 


CList=clistname — 
PROFILE = profilename 
operid|:: 
hciname | 
terminalname _ 
_taskname 
SPAN = spanname_ 
STATUS = {NNT|OPS|TASKS|OPT|SPANS| _ 
_ PROFILES|CNMSESS|AMLUSESS} 
| SCOPE= {aL_|commandname} — | 
| TIMER={ALL|resname} 
| [oP= Aactloperid|rrr|t) 
— -pST= dstname 
oo [op= = {atLloperid|“"}] 
eb: KEV= ={ALLIPFn|PAN} 
|. MSG= LAuTAICOnyy: 
1 DSILoG” i 2 ee are 
ere DSITRACE eee orig oy a 


LIST 


where: 
CLIST =clistname is the name of the CLIST you want displayed. 
_ PROFILE=profilename __ is the name of the profile you want displayed. 


operid | displays current information for the specified operator. 
| This information includes the terminal name that the 
operator is using, the name of the hard-copy log being | 
used, the profile name being used, the session status, 
the domain list, and the active span list. 


two single apostrophes (‘’) in place of the name indi- 
cate that you want your own status displayed. This 
information includes the terminal name that you are 
using, the name of your hard-copy log, your profile 
name, the status of your session, your domain list, and 
your active span list. 


hclname is the name of the hard-copy log device whose status 
you want displayed. 

terminainame is the name of the terminal whose status you want dis- 
played. 


taskname is the name of the optional task whose status you want 
| displayed. To find out the name of the task, use the List | 
STATUS= OPT Command. 


SPAN = spanname is the list of resources within your span list you want 
displayed. 
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STATUS = NNT 
STATUS = OPS 


STATUS = TASKS 
STATUS = OPT 
STATUS = SPANS 
STATUS = PROFILES 
STATUS = CNMSESS 


STATUS = AMLUSESS 
SCOPE = ALL 


SCOPE = commandname 


TIMER=ALL 


TIMER=resname 


DST =dstname 


OP=ALL 


OP = operid 


KEY=ALL 


KEY = PAn or PFn 


MSG =AUTH 
MSG = COPY 


3-100 NetView Operation 


displays the status of all the NNT (NetView-NetView) ses- 
sions. 


displays the status of all the operator terminals known 
in this domain. 


displays the status of all the tasks in your NetView. 
displays the status of all the active optional tasks. 
displays the status of all the active span lists. 

is the list of profiles known in this domain. 


displays all active communication network management 
(CNM) data sessions with your NetView and the status of 
these sessions. 


displays all VTAM-LU sessions. 


lists the commands that you are authorized to use. All 
the commands are displayed if SCOPE has not been 
defined previously. 


identifies the operands and values in your scope for a 
particular command. 


displays all the pending timer requests, depending on 
the oP operand. If you do not specify the OP operand, all 
pending non-ppT timer elements that you entered are 
displayed. 


displays the status of the named timer request. The 
resname is the optional name specified on the ID 
operand of the AT and EVERY command or generated by 
the system. 


displays the outstanding DST requests. The identifier of 
the operator who made the request, the DST request 
number, the step sequence number, and an indicator for 
the last DST request are displayed. 


lists all operators having the DsT or timer request speci- 
fied. 


lists only requests for the named operator and DST or 
timer request. You can specify operid even if the oper- 
ator is not currently logged on. 


lists the ppT timer requests. 


lists DST or timer requests for your own operator id. If 
you do not specify op, “’ is the default. 


lists the PA and PF key definitions. A message is given 
for keys that cannot be set, or for those that have not yet | 
been set. 


gives you the individual PF or PA key settings. The n can 
be 1 to 24 for PF keys and 1 to 3 for PA keys. 


lists authorized message assignments. 


lists messages that the ASSIGN command uses with the 
COPY operand. 


DSILOG ‘displays the status of the network log. 
DSITRACE displays the status of the trace log. 


Usage Note 


If a status is listed INRECOVERY, you may need to use the error recovery commands 
START, STOP, and MOVE to start processing. For hard-copy log printing, if a status of 
DEVICE DORMANT is given, this means that the task exists, but the hard-copy terminal 
is not connected. 


Timer requests are displayed in the order they are scheduled to run. 

If you are listing information about a domain list, an A indicates an active cross- 
domain session and an | indicates that no cross-domain session currently exists 
but you can start one. 

Scope checking is done on the LIST command and on the DST and OP operands. 


Example 


To display the status of the network log, enter: 
LIST DSILOG 


Response 


Your response will be similar to: 


LIST DSILOG 

TYPE: OPT TASKID: DSILOG TASKNAME: DSILOG STATUS: ACTIVE 
PRIMARY:DSILOGP STATUS:ACTIVE SECONDARY:DSILOGS STATUS: INACTIVE 
AUTOFLIP: YES RESUME: NO 

END OF STATUS DISPLAY 


This means that the task name is DSILOG and it is active. The primary data set 
(DSILOGP) is active while the secondary data set (DSILOGS) is inactive. 
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LISTSESS 


Use the LISTSESS command to display the status of your subsystem sessions. 


The format of the LISTSESS command is: 


where: 
OPCTL displays a listing of all the operator-control sessions. 
FLSCN displays a listing of all the full-screen sessions. 


APPLID=applid displays a listing of the status for all sessions with a particular 
application program. 


SRCLU=srclu displays a listing of status for all sessions with a particular 
c | logical unit. 


Usage Note 
If LISTSESS is entered with no operands, all sessions are listed. 
Example 


| To list all the full-screen sessions that you have active, type: 
~LISTSESS FLSCN | 


Response 
You will see information similar to the following: 


if no sessions are active: 
DS14471 NO FLSCN SESSIONS ARE ACTIVE 


lf sessions are active: 


SESSION STATUS DISPLAY BY FLSCN 
APPLID SRCLU SESSID TYPE DATA DISCONNECT NOTIFY VIGIL SDT 
TSO TAFUZA - - - FLSCN NO PF/ NO YES YES 
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LISTVAR 


The LISTVAR CLIST displays the values of the following variables: APPLID, DATE, HCOPY, 
LU, NCCFCNT, OPID, OPSYSTEM, TASK, and TIME. 


The format of the LISTVAR CLIST is: 


Usage Note 


See NetView Command Lists for an explanation of the variables. 


Exampie 


To display the settings of the variables, type: 


LISTVAR 


Response 


You will see information similar to: 


CNMO1 
CNMQ1 
CNMO1 
CNMQ1 
CNMO1 
CNMO1 
CNMO1 
CNMO1 
CNMO1 
CNMO1 


NYNOAIOIOAQAOMA OA + 


CNM3531 
CNM3531 
CNM3531 
CNM3531 
CNM3531 
CNM3531 
CNM3531 
CNM3531 
CNM3531 


LISTVAR 

APPLID = CNMO1008 
HCOPY = 

LU = H11L42C 
NCCFCNT = 18 

OPID = OPERI 
TASK —s_ =: OST 
DATE —- =: 07/19/85 
TIME = 14:44 


OPSYSTEM = MVS/XA 
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LL2 


The LL2 CLIST requests a link level 2 test for a non-switched SDLC link. It tests a 
communication line between: 


e An NcpP and one of its peripheral physical units 
¢ Two NCPs. 


The format of the LL2 CLIST is: 


where: 
station specifies the name of a link station or physical unit to be tested. 


CANCEL specifies that the currently running test should be stopped. 


CONT specifies that the test being started should run continuously until can- 
celed. | 
ntrans specifies the number of test messages that are to be sent. This value 


can be a number from 1 through 65534. The default is 10. 


nframes specifies the number of test messages that are to be sent to the phys- 
ical unit each time its station is selected. This can be a number from 
1 through 65535. The default is 1. 


string specifies optional user data to be used as part of the test message. 
The default is A through Z. 


Usage Note 


This CLIST generates the following VTAM command: 
MODIFY LL2 


For more information on this command, see VTAM Operation. 
If you omit a positional operand, you must indicate its absence by a comma. 
Example 


To start a link level 2 test for a link to an spLc peripheral node containing physical 
unit DPU3274, use the following command: 


LL2 DPU3274 
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LOGOFF 


The LOGOFF command ends the session between your terminal and the system. 


The format of the LOGOFF command is: 


LOGOFF 


Usage Note 


Any messages that are to be sent to the operator are redirected to another author- 
ized operator. 


Response 


If you have logged off successfully, you will see this message: 


DSTO81I OPERATOR operid, LOGOFF PROCEEDING: TERMINAL=terminalname 
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LPDA 


The link problem determination aid (LPDA) command changes or queries the LPDA 
status of a line or station attached to an NcP. The LPDA command applies to NCPS 
only. 


The format of the LPDA command is: 


where: 


iD=resname is the name of the ncp to which the line or link station is 
attached. 


STATION=resname is the name of the link station whose LPDA status is being 
changed or queried. When STATION is specified, LPDA status is 
changed or queried for that station only. 


LINE = resname is the network name of a line. LPDA status is changed or 
queried for the named line. 


QUERY displays LPDA status for the station or line indicated. 

TYPE1 enables LPDA for the line specified with the LINE operand 
having 386X, 5812 LDM, or 586x modem attributes. 

TYPE2 enables LPDA for the line specified with the LINE operand with 
3867 attributes. 

TYPE3 enables LPDA for the line having 586x, Model 02, 03, 52, or 62 
modem attributes. 

NONE specifies not to enable LPDA for the line specified with the LINE 
operand. 

ALLOW enables LPpa for the station specified with the STATION 
operand. 

BLOCK specifies not to enable LPDA for the station specified with the 


STATION Operand. 
Usage Note 
You can use ALLOW and BLOCK with the STATION operand only. 


The following matrix indicates where the LPDA command will work successfully and 
where it will fail with a sense code. 


Channelized Non- Stations 
Line Channelized Block and 
Line Allow 
SDLC NO YES YES 
BSC NO YES NO 
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Scope checking can be done on the LPDA command. 
Example 


To query the LPDA status Of LINE7 attached to NCP2, type: 
LPDA ID=NCP2,LINE=LINE7/ 


Response 


You will receive a response similar to: 
DS1268I LPDA COMPLETE 


or a message with a sense code indicating LPDA cannot be set. 
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LSESS 


The LSESS CLIST displays the status of your subsystem sessions. 


The format of the LSESS CLIST is: 


where: 

ALL displays a list of all sessions. 

OPCTL displays a list of all operator-control sessions. 
FLSCN displays a list of all full-screen sessions. 


A,applid displays a list of the status of all sessions with the named application 
program. 


S,srclu displays a list of all sessions with the named src/u (source LU). 
Usage Note 


This CLIST generates a LISTSESS command; see “LISTSESS” on page 3-102 for more 
information. 


Example 


To list all operator control sessions, type: 


< PREAH ROE 
ae pe yi 
be B ave Bak RES tae bh he 
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MAINMENU 


The MAINMENU CLIST displays the NetView main menu panel. 


The format of the MAINMENU CLIST is: 


MAINMENU 


Usage Note 


The NetView main menu panel appears when you Jog on to NetView if you use 
LOGPROF1. To use this panel, enter a command listed on the panel on the Cob line. 
After entering a command from this panel, you can return to the NetView main 
menu panel by pressing PF6 (ROLL), PF2 (END), PF3 (RETURN), or by entering the 
MAINMENU CLIST. 


When you use the MAINMENU CLIST, the NetView main menu remains on the NetView 
component stack that is used with ROLL until the component is ended. 


To leave the NetView main menu panel, press PF2 or PF3. 


Chapter 3. Command Facility Command Descriptions 3-109 


MAJNODES 


The MAJNODES CLIST displays all the active major nodes in the domain. 


The format of the MAJNODES CLIST is: 


Usage Note 


This CLIST generates the following VTAM command: 
DISPLAY MAJNODES 


For more information on this command, see VITAM Operation. 
Example 


To display the active major nodes in the domain, type: 
MAJNODES 


Response 


You will receive a response similar to: 
IST3501 VTAM DISPLAY - DOMAIN TYPE = MAJOR NODES 


ISTQ89I VIAMSEG TYPE = APPL SEGMENT ACTIV 
IST@89I ISTPUS TYPE = PU_T4/5 MAJ NODE , ACTIV 
ISTQ89I MOO TYPE = 


TSTO89I ASYS8JES TYPE = APPL SEGMENT ACTIV 
ISTO89I AZ1TSO TYPE = APPL SEGMENT ACTIV 


CDRM SEGMENT » ACTIV 
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MDMCNFG 


MDMCNFG- 


The MDMCNFG command retrieves and updates the 586x modem configuration data. 


The format of the MDOMCNFG command is: 


a iD= =nodé - onan 
STATION = -devicename 


~ [wopem= =. {LOCAL|REMOTE}] - ET ee 
, BROWSE = = (wookAnceiconrclcour.en) 
CHANGE = = ACORAIGICQUPLER) os 


oE LEVEL = 1 [2H] 
where: 
iD = node 


STATION = devicename 


LEVEL=1 


LEVEL=2 


MODEM = LOCAL 


MODEM = REMOTE 


BROWSE = NOCHANGE 


BROWSE = CONFIG 


BROWSE = COUPLER 


CHANGE = CONFIG 


CHANGE = COUPLER 


is the name (one- to eight-characters) of the node that 
will pass the command to the modem. 


is the PU name (one- to eight-characters) of the data 
terminal equipment (DTE) at the end of the link with 
which the modem pair is associated. 


specifies to change the first pair of modems. This is 
the default. 


specifies to change the second pair of modems. 


specifies to change the modem closest to the using 
node that issues the command to the link station. 
This is the default. 


specifies to change the modem closest to the station. 


specifies to display the non-changeable configuration 
operands screen. 


specifies to display the configuration operands 
screen. 


specifies to display the coupler operands and phone 
numbers screen. 


specifies to display the changeable configuration 
operands screen. If you don’t change any field on the 
screens, you receive a message that the modem con- 
figuration is not updated. 


specifies to display the changeable coupler operands 
and phone numbers screen. 
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Usage Note 

You must use either the BROWSE or CHANGE operand. 

You can use this command during installation of the IBM 586x modems to configure 
both local and remote modems from your operator console. The local modems 
must be configured first. 


You can use the MDMCNFG command in a CLIST. 


If you would like to cancel a change to the configuration or cancel a change to the 
coupler screen, enter the CANCEL Command on the command line and press ENTER. 


The MDMCNFG Command only runs under the operator station task (OST). 
The MDMCNFG Command can be scope checked. 


The following combinations are not accepted: 


¢ If MODEM = REMOTE and the configuration is “multipoint” then “network 
function” cannot be “control” 


e If MODEM = LOCAL, secondary/tributary will not be allowed 
e if MODEM = LOCAL, then “transmit clock” cannot be “receive” 


e If LEVEL = 2 and MODEM = LOCAL, then “speed control mode” cannot be 
“console” 


e If LEVEL = 2 and MODEM = LOCAL, then transmit clock must be “external”. 
Example 


To display the changeable configuration operands for the remote modem on the 
link connecting NCP1 and TERM4, use the following command: 


MDMCNFG ID=NCP1,STATION=TERM4 ,MODEM=REMOTE,BROWSE=CONFIG 
Response 


The following screen appears: 


3-112 NetView Operation 


NCCF NETVIEW NCFO1 OPER1 05/16/86 11:57:30 


* BROWSE CHANGEABLE 58XX CONFIGURATION PARAMETERS + 
ID = NCP STATION = TERM4 MODEM = REMOTE LEVEL = 1 


BASIC MODEM CONFIGURATION 


SPEED CONTROL MODE (M=MODEM, D=DTE) 

TRAINING SEQUENCE (L=LONG, S=SHORT) 

CONF IGURAT ION (M=MULTI-POINT, P=POINT TO POINT) 
NETWORK FUNCTION (C=CONTROL/PRIMARY, S=SECONDARY ) 
ANT I STREAMING CY=YES, N=NO) 


TRANSMIT CLOCK OPTION (I=INTERNAL, E=EXTERNAL, R=RECEIVE) 


Z1OF ZO UC SE 


COMPLEMENTARY RFS DELAY MS (O TO 250 IN 10MS INCREMENTS) 
DEFAULT SPEED (F=FULL, B=BACKUP) 
LOCAL LOOP BACK WRAP (Y=YES, N=NO) 
CUSTOMER INFORMATION (10 CHARACTER LIMIT) 
ALARM THRESHOLDS 
RECEIVE LEVEL THRESHOLD -43 DBM (-43 TO 0) 
IMPULSE HITS THRESHOLD 21 (O TO 63) 
LINE QUALITY THRESHOLD 10 (O TO 14) 


HIT ENTER TO END COMMAND 


Figure 3-7. Browse Changeable Configuration Operands 
The fields are described in Appendix B, “List of Panel Fields” on page B-1. 
Your system programmer can use the Change Modem Configuration form to show 


how your operands should be set. See NetView Administration Reference for a 
copy of the Change Modem Configuration form. 
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MDMCNTL 


Use the MDMCNTL command to: 


e Change line speed 


e Close or open a contact (built-in relay) or detect current of a sensor 
e Dial the station using the switched network backup (SNBuU) line 

¢ Disconnect the station and activate SNBU 

e Sense current on a sensor relay of the modem. 


The format of the MDMCNTL command is: 


where: 


iD = usingnode 


STATION = devicename 


LEVEL =1 
LEVEL =2 


MODEM =LOCAL 


MODEM = REMOTE 
MODEM=ALLRMT 
SPEED = FULL 
SPEED = BACKUP 
CONTACT =CLOSE 


CONTACT =OPEN 
CONTACT = QUERY 
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is the name (one to eight characters) of the node that 
will issue the command to the station. 


is the PU name (one to eight characters) of the data ter- 
minal equipment (DTE) at the end of the link with which 
the modem pair is associated. 


specifies to change the first pair of modems. This is the 
default. 


specifies to change the second pair of modems. 


specifies to change the modem closest to the using 
node that issues the command to the link station. This 
is the default. | 


specifies to change the modem closest to the station. 


requests the operation for all the remote modems 
attached to the local. It is valid with the speed operand 
only. 


changes the transmit speed of the modem to full. This 
operand can only be specified when LEVEL = 1. 


changes the transmit speed of the modem to the backup 
speed. This operand can only be specified when 
LEVEL =1. 


closes a contact. 
opens a contact. 


detects the state of the contact and the electrical current 
flowing through the sensor. 


CONNECT = phone dials out on a switched network backup line. This can 
only be used with MODEM=LOCAL. 


DISCONN disconnects a station on the switched network backup 
line. This can only be used with MODEM=LOCAL. 


Usage Note 


These functions apply to the 586x modems. You cannot specify LEVEL =2 and the 
SPEED operand together. 


Scope checking can be done on the MDMCNTL command. 
Example 


The communications link between LANCP2 and NYSNA1 has problems and a.request 
has been received to use the backup link until the problem is resolved. The phone 
numbers for the backup link are 1-800-555-6789 and 1-800-555-6790. To do this 
enter the following command: 


MDMCWTE ID=LANCP? .STATION=NYSNAT ,CONNECT=( 16005556789 , 18005550790 | 


omy 
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MOVE 


The MOVE command shifts activity from one NetView terminal to. another. 


The format of the MOVE command is: 


where: 


FROM=terminalname _ specifies the terminal from which you are moving work. 


TO=terminalname specifies the terminal to which you will be moving work. 
The terminalname must be the same device type as the 
FROM terminal name. 


Usage Note 

You cannot move your own terminal's work. The terminal for which work is being 
moved (FROM terminalname) must be in an error state. You cannot move a task in 
recovery status to a terminal (To terminalname) that another application program 
is using. 

In automated operations, you cannot move from or to an automated task. 

Terminal names are network resource names of terminal devices of the same type. 
The MOVE command is restricted to devices defined with a POS or HARD-CoPyY state- 
ment. 


Example 


Suppose you are using terminal A. To move terminal B’s work to terminal C, type: 


MOVE FROM=B, TO=C 
and press ENTER. 


Response 


When the move has completed, you will get this message: 


DSI0381I ACTIVITY FOR TASK MOVED FROM TERMINAL 
terminalname TO terminalname 
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MSG 


The MSG command sends a message to an operator or to the network log. 


The format of the MSG command is: 


MSG {PPT|LOG|ALL|SYSOP|operid} 


text 
where: 
PPT indicates that the message text is to be sent to the PPT task. This 


message will be scanned under the PPT to determine if it is to be auto- 
mated and cause a command or CLIST to be executed. If it is not sup- 
pressed, it is sent to the authorized message receiver. 


LOG means the message is written on the network log file, if active. 

ALL means the message is sent to all active terminals in this domain and 
to the system console. 

SYSOP means the message is sent to the system console operator. 

operid is the operator to whom you are sending the message. 

text is the message text. 

Usage Note 


A comma or blanks must come before the message text. All characters after the 
comma or blanks are considered part of the text. You can use blanks and commas 
in the text. Quotation marks (”) or apostrophes (’) are not required; if they are in 
the text, they are treated as part of the text. 

You can use AUTHRCV as a synonym for the PPT operand. 


Example 


To send a messages to your users, type: 
MSG ALL,SYSTEM SHUTDOWN IN 10 MINUTES 


Response 


Here is what the receiving operators will see: 


DSIO39I1 MSG FROM NCFQ1 SYSTEM SHUTDOWN IN 10 MINUTES 


Here is what you will see: 
DSTOO1I MESSAGE SENT TO ALL 
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uvs MVS 


The MVS command is used to enter an Mvs system operator command from 
NetView. 


The format of the MVS command is: 


where: 

commandtext is an MVS Command, a JES2/3 command or any other mvs 
subsystem command. 

Usage Note 


Commands in the master console (mC) only group may not be issued from NetView. 
Refer to MVS Operator Library: Commands for a discussion of command groups. 


Scope checking can be specified on the first keyword (using KEYCLASS) and the next 
token (using VALCLASS). 


Example 


MVS MODIFY TSO,USERMAX = NNNN 


The above command can be scope checked as follows: 


MVS CMDMDL MOD=CNMCMVS , TYPE=R,RES=Y 
CMDCLASS 1,2,3,4 

MODIFY KEYCLASS 1,2 

TSO VALCLASS 1 
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NCPDUMP 


The NCPDUMP CLIST initiates a dump of an active NCP. 


The format of the NCPDUMP CLIST is: 


NCPDUMP ncpname 


[,stationname 
[,RMPQ|,DYNA]] 
[,PDS = resname] 


EL CSP|,Moss],NCP] 


where: 
ncpname 


stationname 


RMPO 


DYNA 


is the name of the NcP to be dumped. 


is the name of a link station in a node adjacent to the NcP to be 
dumped through which a static dump operation is to be performed. 


specifies that the communication controller should have the power 
turned off after the NcP is dumped statically. 


specifies that the communication controller should not have the 
power turned off, and that the NcP is to be dumped dynamically. 


PDS = resname identifies the file that is to contain the dump. 


CSP 


MOSS 


NCP 


Usage Note 


specifies that a communication scanner processor dump contained 
on the moss disk in the 3725 communication controller is to be sent 
to the host and stored in a host data set. 


specifies that a maintenance operator subsystem dump contained 
on the moss disk in the 3725 communication controller is to be sent 
to the host and stored in a host data set. 


specifies that the NcP in the communication controller’s main 
storage is to be dumped and the resulting dump is to be sent to the 
host and stored in a host data set. 


This CLIST generates the following VTAM command: 


MODIFY DUMP 


For more information on this command, see VTAM Operation. 


If you omit a positional operand, you must indicate its absence by a comma. 


If you specify DYNA, you cannot specify CSP or MOSS. 


if you specify RMPO, you cannot specify CSP or MOSS. 


If you specify stationname, you cannot specify DYNA, MOSS, or CSP. 
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Example 


If you want to take a dynamic dump of NCP1 and put the results in a file defined by 
NCPDUMP, issue the following CLIST: 


NCPDUMP NCP1,DYNA,PDS=NCPDUMP 
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NCPSTOR 


The NCPSTOR CLIST displays the storage contents of a communication controller 
running an NCP. You can display up to 256 (decimal) bytes from any address within 
the communication controller. 


The format of the NCPSTOR CLIST is: 


NCPSTOR ncpid 


,addr 
[,/ength] 
where: 
ncpid specifies the name of the ncp whose storage is to be displayed. 
addr specifies the address (in hexadecimal) of the first byte of data to be dis- 
played. 


length specifies the number of bytes of NcP storage to be displayed. The value 
can be any decimal number from 1 through 256. The default is 32. 


Usage Note 


This CLIST generates the following VTAM command: 
DISPLAY NCPSTOR 


For more information on this command, see VTAM Operation. 
Example 


To list the storage contents of NCP572P, beginning with address 260 for 32 bytes, 
type: 
NCPSTOR NCP572P,260 


Response 


The response will be similar to: 


TSTO971 NCPSTOR ACCEPTED 

TST2441 NCP STORAGE FOR ID = NCP572P 

IST245I 000260 81C2282F 104828AE 415CFOOF 99152883 
TST2451 600270 O108E1FO 80864154 A821D410 25B9F2A0 
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NETWORK 


The NETWORK CLIST displays all networks defined to an NCP. 


The format of the NETWORK CLIST is: 


where: 


ncpid specifies the name of the ncp for which all defined networks are to be dis- 
played. 


Usage Note 
A maximum of five networks can be displayed. 


Warning: Incorrect results may occur when running the NETWORK CLIST while 
MSGMOD is on. 


This CLiST generates the following VTAM command: 
D NET,NCPSTOR,1D=ncpid 


For more information on this command, see VTAM Operation. 
Example 


To display the networks defined to NCP21, enter: 
NETWORK NCP21 
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NEWS 


The NEWS CLIST displays messages from your network control center. 


The format of the NEWS CLIST is: 


Usage Note 


These messages are updated by your system programmer. 
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NODE 


The NODE CLIST provides information about a particular major node or minor node. 
You can also receive information about the node’s subordinate resources. 


The format of the NODE CLIST is: 


where: 

resname is the name of the major node or minor node. The default is your ter- 
minal. 

ACT displays status information about the named resource (resname) as 
well as the names and status of all its active subordinate resources. 

INACT displays status information about the named resource (resname) as 
well as the names and status of all its inactive subordinate resources. 

ONLY displays status information about the named resource (resname) 
only. 

ALL displays status information about the named resource (resname) as 
well as the names and status of all its subordinate resources. This is 
the default. 

netid limits the scope of the display to a specific network for cross-domain 
resource major and minor nodes only. 

Usage Note 


This CLIST generates the following VTAM command: 
DISPLAY NET 


For more information on this command, see VTAM Operation. 
Example 


To display information about the channel-attached major node CTCA7F0 and its sub- 
ordinate resources, use the following command: 


NODE CTCA7FO,ALL 
Response 


You will receive a response similar to: 


ISTO97I DISPLAY ACCEPTED 

TISTO75I VTAM DISPLAY - NODE TYPE = CA MAJOR NODE 

IST486I NAME= CTCA7FO, STATUS= ACTIV, DESIRED STATE= ACTIV 
IST654I 1/0 TRACE = ON, BUFFER TRACE = N/A 

IST170I LINES: 

IST2321 CTCL. » ACTIV----E, CUA = 7FQ 

IST3141 END 
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NOSTAT 


The NOSTAT CLIST stops the recording of tuning statistics. 


The format of the NOSTAT CLIST is: 
NOSTAT 


Usage Note 


This CLIST generates the following VTAM command: 
MODIFY NOSTAT 


For more information on this command, see VTAM Operation. 
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OVERRIDE 


The OVERRIDE command sets message processing options to be used instead of 
those selected by the message automation table for a particular operator. The 
OVERRIDE options take precedence over the options specified by the DEFAULTS 
command. These options apply to all messages that are to be displayed at the 
individual operator's terminal. 


The format of the OVERRIDE command is: 


where: 


HOLD = {ENABLE|DISABLE|DEFAULT} Defines whether or not the HOLD action is to be 
taken from the message automation table. 


BEEP = {ENABLE|DISABLE|DEFAULT} Defines whether or not the BEEP action is to be 
taken from the message automation table. 


SYSLOG = {YES|NO|DEFAULT} Defines whether or not all messages are written 
to the system log. 

NETLOG = {YES|NO|DEFAULT} Defines whether or not all messages are written 
to the network log. 

HCYLOG = {YES|NO|DEFAULT} Defines whether or not all messages are written 
to the hard-copy log if an operator has one 
active. 

DISPLAY = {YES|NO|DEFAULT} Defines whether or not all messages are dis- 


played on NetView terminals. 
Usage Note 


DEFAULT sets the processing back to using the DEFAULTS command and message 
automation table processing. 


The NetView-provided actions for your operator iD (when you do not uSe OVERRIDE) 
are determined from the DEFAULTS command and the message automation table. 


DISPLAY = NO allows all messages to be suppressed by an operator. 
Scope checking can be done on the OVERRIDE command. 
Response 


No messages are produced if this command runs correctly. 
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PATHS 


The PATHS CLIST displays dial-out path information about a switched physical unit. 


The format of the PATHS CLIST is: 


“PATHS resname 


where: 


name specifies the name of a switched physical unit. 
Usage Note 


This CLIST generates the following VTAM command: 
DISPLAY PATHS 


For more information on this command, see VTAM Operation. 
Example 


To display the dial-out path information for physical unit HD3790N1, use the following: 
PATHS HD3790N1 


Response 


You will see a display similar to: 


TSTO971I DISPLAY ACCEPTED 

TST1481I DIAL OUT PATH INFORMATION FOR PHYSICAL UNIT HD3790N1 

IST149I LINE GRP TELEPHONE NUMBER OR LINE NAME PID GID CNT 

IST1681 EGROUP40 4094 001 001 005 AVA AUT 
TST168I EGROUP5O 4094 002 002 001 AVA MAN 
IST3141 END 


PID is the path identifier, GiD is the group identifier, and CNT is the retry count. AVA 


means the path is available, and AUT or MAN shows whether the dial-out is auto- 
matic or manual. 
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PENDING 
: | The PENDING CLIST displays information about nodes in the domain in a pending 
state. 


The format of the PENDING CLIST is: 


Usage Note 


This CLIST generates the following VTAM command: 
DISPLAY PENDING 


For more information on this command, see VITAM Operation. 
Example 


To display nodes in a pending state, type: 
PENDING 


Response 


You will see information similar to: 


IST350I VTAM DISPLAY - DOMAIN TYPE = PENDING 
IST159I THE FOLLOWING NODES ARE IN A PENDING STATE 


ISTO8OI MO9 PACDR M10 PACDR H21CC94P PCTD1 
ISTO80I P668B PCTD1 P1402C = PCTD1 P45A2 PCTD1 
ISTO80I P45A5CE PCTD2 T45A5E00 INOP T45A5EQ1 INOP 


IST3141 END 


In this example, node Mog is in the PACDR state. To display the meaning of PACDR, 
use the STATUS CLIST. 
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PFKDEF 


The PFKDEF CLIST sets PF keys for an operator station task (OST) for the command 
facility, hardware monitor and 4700 support facility. It does not apply to any other 
NetView components. 


The format of the PFKDEF CLIST is: 


PFKDEF 


Usage Note 
The PFKDEF CLIST cannot run under the PPT. 
This CLIST can be customized by your system programmer. If this CLIST is custom- 


ized, the system programmer should update the PF key descriptions in Appendix F 
of this book. 
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vu PRINTLOG 


The PRINTLOG CLIST prints the network log or trace log. 


The format of the PRINTLOG CLIST is: 


where: 

L indicates network log. 
T indicates trace log. 

P prints primary log. 
S 


prints secondary log. 
Usage Note 
This CLIST is available on vm only. 
Example 


To print the primary trace log only, enter: 
PRINTLOG T P 
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PURGE 


‘PURGE © 


The PURGE command purges a timer request scheduled by the AT or EVERY 
command or purges a DST request with which there is a problem, such as a request 
unable to complete. 


The format of the PURGE command is: 
Aon <(ptutrespamay: 
[,oP= “fopeniatren ey 


| ‘DsT= dsiname®. 
| ;REQ= {requesinumber|Auty 7 
Abe op= “{operia|"H 


where: 

TIMER = ALL tells the system that all pending timer requests are to be 
purged, depending on the op operand. If you do not specify 
the OP operand, all pending timer elements you entered 
without the PPT operand are purged. 

TIMER =resname indicates that the named timer request sent under the 
operator or task specified on the oP operand is to be 
purged. 

OP = operid identifies the operator whose timer or DST requests are to 
be purged. | 

OP=PPT specifies to purge PPT timer elements. 

OP=*' specifies to purge non-PPT timer elements, or DST requests 
sent by you. 

DST =dstname is the task name of the DST that is processing the request. 
Scope checking is performed on this operand and its 
values. 


REQ=requestnumber is the DST request number you want purged. The DST 
numbers are obtained with the command LIST 
DST = dstname. 


REQ= ALL indicates that all DST requests for the operid specified on 
the OP operand are to be purged (maximum value is 999). 


Usage Note 


Scope checking is done on the PURGE command and on the TIMER, DST, OP, and REQ 
commands. 


Example 


To purge all outstanding non-PPT timer requests, type: 
PURGE TIMER=ALL 
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To purge all outstanding DST requests for BNUDSERV that are from operator HELPDSK1, 
type: 
PURGE DST=BNJDSERV, REQ=ALL, OP=HELPDSK1 


Response 


If the purge is successful, you will see: 

DSI2Q05I nnn TIMER ELEMENTS PURGED OP = operid 
or 

DSI5101 taskname: rrr REQUESTS PURGED 


In the example, rrr is the decimal number of requests purged. 
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QHCL 


The QHCL CLIST displays information about the hard-copy log (printer), if one exists. 


The format of the QHCL CLIST is: 


QHCL 
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RCFB 


The RCFB CLIST displays information describing the specified return code and feed- 
back code. Only vTAM return codes and feedback codes are handled by this CLIST. 


The format of the RCFB CLIST is: 


where: 
rtncd specifies the hexadecimal return code. 


fdbk2 specifies the hexadecimal feedback code. 
Usage Note 
Leading zeros are not required for the return or feedback codes. 


This command is not allowed if NetView is installed with the DASD Conservation 
Option. (See “DASD Conservation Option” on page 2-8.) 


Example 


To display the meaning of return code 8 and feedback code 0, type: 
RCFB 8,0 


Response 


The following screen appears: 


Figure 3-8. Return Code and Feedback Code Panel 
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RECYCLE 


The RECYCLE CLIST deactivates, and then activates a network node. 


The format of the RECYCLE CLIST is: 
RECYCLE resource — 


where: 


resource specifies the name of a network node to be deactivated and then acti- 
vated. 


Usage Note 


This CList generates the following VTAM command: 
VARY INACT 


If message IST105! indicates the device is inactive, the following command is also 
generated: 


VARY ACT 


This CList sends the VARY ACT command to the system until message !STo0931 indi- 
cates that the resource is active. After 40 seconds, this CLIST ends. 


The RECYCLE CLIST cannot run under the PPT. 
Example 


To deactivate and activate node HD3790N1, type: 
RECYCLE HD3790N1 
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REDIAL 


The REDIAL CLIST requests that VTAM search for an alternate path if a dial-out attempt 
is unsuccessful or end a session request without searching for an alternate path. 


The format of the REDIAL CLIST is: 


where: 
linename __ specifies the resource name of a switched line. 


END specifies to end the session request without searching for an alter- 
nate path. 


Usage Note 


This CLIST generates the following VTAM command: 
VARY INOP 


For more information on this command, see VTAM Operation. 
Example 


To search for an alternate path for LINE27, use the following command: 
REDIAL LINE27 


3-136 NetView Operation 


REL 


The REL CLisT releases a previously acquired NcP or releases a physical unit 
attached by a non-switched line to an NCP. 


The format of the REL CLIST is: 


REL {ncpname|puname} _ 
LACTIINACT] — 


[1] 


where: 
ncpname specifies the name of the nNcP to be released. 
puname specifies the name of the physical unit to be released. 


ACT for an NCP, specifies that active cross-domain links and link stations 
are to remain active after they are released. This is the default. 


INACT for an NCP, specifies that cross-domain links and link stations within 
the scope of the release are to be deactivated as part of the NCP 
release processing. 


l specifies immediate release. If not specified, normal release occurs. 
Usage Note 


This CLiST generates the following VTAM command: 
VARY REL 


For more information on this command, see VTAM Operation. 
Example 


To release previously acquired NcP1, use the following command: 
REL NCPi 
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uvs RELCONID 


The RELCONID Command releases the Mvs subsystem console ID that was obtained in 
a previously issued MVS command. 


The format of the RELCONID command is: 


Usage Note 


A NetView operator ID obtains an Mvs subsystem console |ID when it issues an Mvs 
command. For normal operation, the RELCONID command is not needed since an 
operator ID that is authorized to issue the MvS command will need to retain its sub- 
system console ID in order to receive command response messages and to issue 
more MVS commands. An operator ID’s console ID is always released when the 
operator logs off without any need to issue RELCONID. 


The RELCONID command should not be used in message automation CLISTs designed 
to run under an automation task that issues MvS commands because if a subsystem 
console ID is not available, the MvSs command will fail and the intended automation 
action will not take place. 
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REPLY 


The REPLY command responds to outstanding VTAM requests. 


The format of the REPLY command is: 


where: 

Pnn or Lnn is the reply number that appeared on a message. 
text is the information that you want to give to VTAM. 
Usage Note 


Note: vM users must use spaces instead of the comma in the command syntax. 


When a VTAM message appears with the following format: 


Pnn messagenumber messagetext 


or 


Lnn messagenumber messagetext 


the message requests a network operator reply. The NetView reply command 
should be entered using the reply ID (Pnn or Lnn) from the message. 


Example 


If you have the following message on your NetView screen: | 
P45 IST272A NO INITIAL TEST FOR AO8NV6 - REPLY 'U' TO BYPASS - OR CANCEL 


you can respond using the P45. For example: 
REPLY P45, CANCEL 
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RESET 


The RESET command ends the command or CLIST that is running. 


The format of the RESET command is: 


where: 


NORMAL tells the system that a command should be stopped at its next break- 
point even if work remains to be done. RESET NORMAL may not work 
for a command processor that has no breakpoint. You may have to 
uSe RESET IMMED instead. 


CAUTION: 
Using RESET IMMED can be tried but it could interrupt the current 
process. 


NORMAL is the default for RESET. 


IMMED tells the system to end the command immediately. All processing 
stops and the results are lost. You may lose some messages already 
designated as output but not sent to the screen. Spans are not 
affected. Your cross-domain session is lost (if you had one). Ter- 
minal access facility sessions are lost also. 


DUMP similar to RESET IMMED, but specifies that a dump is also taken. 
Usage Note 
The RESET command is an immediate command. 


Do not enter the RESET IMMED or RESET DUMP command after a CLOSE command has 
run. If you do, you will be logged off and will not be able to log back on until 
NetView restarts. If you are in a cross-domain session and you send a RESET IMMED 
with the ROUTE command to a NetView in another domain, it has the same effect as 
stopping the cross-domain session. 


Be careful when you use the RESET IMMED. Each time you use it, you increase the 
abnormal end count. When you go over the maximum count as defined by your 
system programmer, your terminal! will be logged off. 


RESET IMMED cleans up the storage associated with your osT. If you are using a 
function that runs partially under your OST and partially under a DsT (for example, 
session monitor and hardware monitor), the associated DST is not affected by the 
RESET command. Data returned from the DST may be discarded or ignored since 
any correlation data kept under the ost has been lost. Since the OST part of the 
function has lost its storage, it may send duplicate requests to the DST and thus 
cause problems in the DsT part of the function. 
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Response 


Normal response to REPLY NORMAL: 


You get the following message only if a command or CLIST is running; other- 
wise, you get no response. 


DSTO52I command COMMAND SELF-TERMINATED BY OPERATOR REQUEST 


The normal response to RESET IMMED or RESET Dump is these messages: 


DS11311 COMMANDS ABENDED BY RESET COMMAND. STATION HAS BEEN RESET. 
DSI172I SUBTASK {]uname/operatorid} ABENDED WITH CODE X'G00101' 
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RETRIEVE 


The RETRIEVE command places the last command you issued in the command input 
area. The keyboard will be unlocked. You can alter or erase the command. If you 
press ENTER, the command will run. 


The format of the RETRIEVE Command is: 


Usage Notes 


If, instead of processing the command displayed, you reissue the RETRIEVE 
command, the next to last command issued re-appears in the command input area. 
You can issue the RETRIEVE command repeatedly until you have retrieved the 
command you are looking for. 


The number of commands retrieved depends on the length of the commands you 
entered. The guide lines are: 


240 characters 3 
80 characters 9 


40 characters 14 


If the command you are retrieving is the entire length of the input area, the last 
character is dropped and replaced with the cursor. 


PF12 is set to the RETRIEVE command. 

lf you want to use the RETRIEVE command in the hardware monitor, you must have a 
programmed function (PF) key defined for this purpose. (Note: PF12 defaults to 
RETRIEVE.) 

You cannot type the RETRIEVE command in the session monitor, the status monitor, 
or the browse facility. For the session monitor, you can use PF12, which is Set to 


RETRIEVE. 


You cannot retrieve commands issued by PF keys or suppressed commands. You 
cannot retrieve the RETRIEVE command. 
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RETURN 


The RETURN Command returns to the previous component or the last selection panel 
that you used. 


The format of the RETURN Command is: 
RETURN 


Usage Note 

PF3 is set to the RETURN Command if you use the PFKDEF CLIST. (Ask your lead oper- 
ator if your default PF key settings are established.) This command should not be 
issued from a CLIST. 


RETURN does not work in STATMON, BROWSE, the HELP facility, MAINMENU, Or HELPDESK. 
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The ROLL command returns to a previous component and panel that you used in 
that component. 


The format of the ROLL command is: 


Usage Note 


PF6 is set to the ROLL command if you use the PFKDEF CLIST. (Ask your lead operator 
if your default PF key settings are established.) 


The system remembers the sequence in which you go from one component to 
another. When you use the ROLL command, the system moves the name of the 
current component at the beginning of the sequence of components, and re-enters 
the component at the end of the sequence, displaying the panel that was displayed 
when you last left the component. 


Example 


If you previously entered NLDM, followed by the HELP Poompecen followed by NPDA, 
the sequence remembered is: 

NLDM - HELP - NPDA 

To re-enter the help facility where you left off, enter the command: 

ROLL 
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ROUTE 


The ROUTE command sends NetView and VTAM commands to other domains. 
The format of the ROUTE command is: 


ROUTE  domainid 
| - ,command 


where: 

domainid is the name of the NetView domain where the command is sent. 
command is the command that is sent. 

Usage Note 

The ROUTE command sends NetView or VTAM commands to other domains. When 
you are connecting to other subsystems by means of TAF, only operator-control 
(OPCTL) commands can be routed. You can also use the ROUTE command to send 


logon information to other domains after these domains have started. 


Any messages associated with the command being sent are returned to the 
sending terminal. 


Do not use the ROUTE command to route commands that produce full-screen output 
such aS HELP Or HELPDESK. 


If the suppression character defined by your system programmer is used as a 
prefix with the ROUTE command, neither the ROUTE Command nor the command that 
is sent will be echoed to the screen or logged. 


Example 


If you want to display the status of a resource named LU2024A1 in domain D2, type: 
ROUTE D2,DISPLAY NET, ID=LU2024A1 
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RSESS 


The RSESS CLIST returns the operator to a previously disconnected full-screen ter- 
minal access facility session. 


The format of the RSESS CLIST is: 


applid specifies the logical unit name of the subsystem you want to return to. 
This name must match the APPLID specified in a previous BGNSESS 
command. 


Y means that you will hear the terminal alarm when information is sent to 
NetView. You will also hear this alarm when you press ENTER Or a PA Or PF 
key. The alarm will continue until you disconnect from the session. You 
may then return to your session and the alarm will not sound until 
another message (information) is received. If omitted, vicit defaults to 
the selection made in the previous BGNSESS Or RTRNSESS command for this 
session. 


N means that you will not hear the terminal alarm when information is sent 
to NetView. You can display the messages (information) when you dis- 
connect from the subsystem. If omitted, vici. defaults to the selection 
made in the previous BGNSESS or RTRNSESS command for this session. 


PAn specifies the PA (1-3) key you want to be the disconnect key during the 
full-screen session. If omitted, D defaults to the selection made in the 
previouS BGNSESS or RTRNSESS command for this session. 


PFn specifies the PF (1-24) key you want to be the disconnect key during the 
full-screen session. If omitted, D defaults to the selection made in the 
previous BGNSESS Or RTRNSESS command for this session. 


CLR specifies that CLEAR is to be the disconnect key during your full-screen 
session. If omitted, D defaults to the selection made in the previous 
BGNSESS Or RTRNSESS Command for this session. 

Usage Note 

This command generates a RTRNSESS command, see “RTRNSESS” on page 3-147 

for more information. If you omit a positional operand, you must indicate its 

absence by a comma. 


Example 


To return to a full-screen TSO1 Session using PF12 as the disconnect key, type: 
RSESS TSO1,N,PF12 


Since N is specified, you will not be interrupted with messages. 
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RTRNSESS 


The RTRNSESS Command returns you to a previously disconnected full-screen 
session with any of the subsystems. 


The format of the RTRNSESS command is: 


RTRNSESS = APPLID=applid 


where: 


APPLID = applid 


VIGIL=Y 


VIGIL=N 


D=PAn 


D=PFn 


D=CLR 


Usage Note 


Be — — 2 [= {Pan|PFn|ciR}] a : ‘ Boh Magy eo een ee og ekg ones 


specifies the logical unit name of the subsystem you want to 
return to. This name must match the APPLID specified in a pre- 
viouS BGNSESS command. 


means that you will hear the terminal alarm when information 
is sent to NetView. You will also hear this alarm when you 
press ENTER Or a PA Or PF key. The alarm will continue until you 
disconnect from the session. You may then return to your 
session and the alarm will not sound until another message 
(information) is received. If omitted, vicit defaults to the 
selection made in the previous BGNSESS or RTRNSESS Command 
for this session. 


means that you will not hear the terminal alarm when informa- 
tion is sent to NetView. You can display the messages (infor- 
mation) when you disconnect from the subsystem. If omitted, 
viaiL defaults to the selection made in the previous BGNSESS or 
RTRNSESS Command for this session. 


specifies the PA (1-3) key you want to be the disconnect key 
during the full-screen session. If omitted, D defaults to the 
selection made in the previous BGNSESS or RTRNSESS command 
for this session. 7 


specifies the PF (1-24) key you want to be the disconnect key 
during the full-screen session. If omitted, D defaults to the 
selection made in the previous BGNSESS or RTRNSESS Command 
for this session. 


specifies that the CLEAR is to be the disconnect key during your 
full-screen session. If omitted, D defaults to the selection made 
in the previous BGNSESS or RTRNSESS command for this session. 


The viGiL operand replaces the existing INT operand. For address 16, INT is still a 
valid operand but now functions the same way as VIGIL; the operator is no longer 
interrupted but only alerted by the terminal alarm of information coming to 


NetView. 


If you have a session started to a destination system that does not automatically 
send an initial output screen (for example, the cics “good morning” message 
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screen), you must enter RTRNSESS and press the ENTER key before you can use the 
session. 


If you are using the color, graphics, or larger screen sizes, there may be data 
missing when you return to the application. If this happens, use the REFRESH key to 
cause the information to be redisplayed on your screen. 


Example 


To return to a full-screen CICS1 session using PF12 as the disconnect key, enter: 
RTRNSESS APPLID=CICS1,D=PF12 
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RUNCMD 


The RUNCMD command allows service point application commands to be sent to a 
service point and executed by a given service point application. 


The format of the RUNCMD command is: 


RUNCMD ~—s- SP= service point name, 


___-APPL=applicationname, = 
_- command_string 


where: 

SP specifies the name of the service point to execute the 
command. 

APPL specifies the name of the link connection subsystem manager 
(LCSM) to execute the command. 

command_string is the command to be executed. 


Note: The limit on the length of the RUNCMD is 240 characters. 
Usage Note 


The operands on the RUNCMD are positional. The given command (command string) 
must be the last operand and may be any format. 


Scope checking can be done on the RUNCMD command. 


Example 

RUNCMD SP=SP0Q1, APPL=APPLO2, DISPLAY LINES 

Response 

The normal response to RUNCMD command will either be message(s) from the 
service point application or message DSI2681 RUNCMD COMPLETE when no messages 


are returned from the service point application. The messages returned may be 
command facility or service point application messages. 


Chapter 3. Command Facility Command Descriptions 3-149 


RUNDIAG 


The RUNDIAG command performs online diagnostics in a 3710. An operand on the 
command specifies the diagnostic test to be run. 


The format of the RUNDIAG command is: 


where: 


ID=resname is the network name of the 3710 to which the device being 
tested attaches. 


PORT = portnumber is the number of the port to be tested. The valid port 
numbers are 1AA, 1BB, 1CC, 1DD, and so on, up to and 
including 16AA, 16BB, 16CC, and 16DD. 


LINE=resname is the network name of the fine to be tested. 
TEST = testid is the 1D of the specific diagnostic test to be run. The valid 
test IDS are: 


1 — To test a communication adapter 

2 — To test a cable 

3 — To test the service modem. 
Usage Note 


For addresses 1 through 15, ports AA, BB, CC, and DD are valid. For address 16, only 
ports AA and BB are valid. 


For detailed information on how to run the diagnostic tests, see 3710 Network Con- 
troller Host Guide. 


Scope checking can be done on the RUNDIAG command. 
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SENDSESS 


The SENDSESS command sends a command to CICS/Vs (MVS only), IMS/VS (MVS Only), 
HCF (MVS Only), or another NetView session. A session must already exist with the 
subsystem before commands are sent using the SENDSESS command. 


The format of the SENDSESS command is: 


SENDSESS 


where: 


sessionid 


text 


* 


sessionid 


is the session identifier (SESSID) you previously specified in the BGNSESS 
OPCTL Command for this session. If SESSID was not specified, the APPLID 
value is used as the session identifier. 


is the command, message, or other text you want sent. It should be in 
the format required for CICS/VS, IMS/VS, Or HCF. 


specifies that you request permission to send again. 


When you use *, you send an attention to the subsystem. It simulates the attention 


key. 


Usage Note 


Any messages associated with the text will be received by whoever sent the 
SENDSESS Command. 


A semicolon (;) in the text is used as a logical carriage return. You can enter 
several commands or “logical lines” to CICS/VS, IMS/VS, Or HCF using a semicolon to 
indicate the end of each logical line. To send a single semicolon to a subsystem 
you should use two semicolons in a row (;;). 
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SET 


The SET command defines PA and PF keys for the command facility and the hard- 
ware monitor. These settings remain valid only until you log off. 


The format of the SET command is: 


where: 


PFn or PAn specifies which key you want set, either a PF (program function) 
key or a PA (program attention) key. You cannot set PF keys that 
are set to a command module statement. You can specify 1 to 24 
for PF keys and 1 to 3 for PA keys. (Your keyboard may not have 
that many PF or PA keys. Some keyboards have only 12 PF and 2 PA 
keys.) When you type the key number, do not leave a space 
between the PF or the PA and the number. | 


IMMED tells the system that this command should run immediately when 
« you press the key. Use this for commands you want to enter the 
same way each time. 


DELAY tells the system to write the command in the input area of the 
screen and place the cursor after the last character. The 
command will run when you press the ENTER key. This lets you 
modify the command before it is started. 


APPEND tells the system to append the data in the input area to the end of 
the command text from the SET command when you press the PF 
key. 


PA keys do not send data, therefore do not use the PA key and the 
APPEND operand together. | 


IGNORE tells the system to ignore the input area for this key. You must 
type IGNORE after the PF or PA key and before the command text. 


text is the command or command list you want specified for the PF or PA 
key. Acomma or blanks must come before the message text. All 
characters after the comma or blanks are considered part of the 
text. You are allowed to use blanks and commas in the text. Quo- 
tation marks (”) or apostrophes (’) are not required; if they are in 
the text, they are treated as part of the text. 


Usage Note 


Although the command facility SET command can be used to SET 4700 support 
facility PF keys, it must be done in command facility or prefixed by NCCF. 


If the SET command is attempted on an NNT or the PPT, a warning message is issued 


and no action is taken. This is because the NNT and PPT tasks do not have termi- 
nals, and therefore do not have PF or PA keys to set. 
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if an operator starts a cross-domain session and specifies a profile that has an 
initial command or CLIST, a SET Command might unintentionally be attempted. An 
initial CListT should check the task before attempting SET. 


The SET command should not be included in the CLIST used on the NCCFIC initializa- 
tion card in DSIDMN. The NCCFIC command or CLIST is run under the PPT. 


This CLIST can be customized by your system programmer. If this CLIST is custom- 
ized, the system programmer should update the PF key descriptions in this book in 
Appendix F. 


Example 


To set the PF12 key to retrieve your last command, enter: 


me enon nantes wees pte ot BS Yeh betty, vam fey ae pee 

Tce eee ee ‘ aby} we Btiset Meat Bilatag, BRCM, 

a ee 7 MPI E fee go gyri ofl ot “Ey 

ret Been am re ee Si Pr ee a Te San coe Poe ie 
Gt 


Response 


To use the PF, press PF12. Notice that the SET PF12 command is placed in the 
command area. 
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SETCGLOB 


The SETCGLOB CLIST sends a message to the NetView PPT task to request that a spec- 
ified common global variable should be set to a specified value. The variable’s 
value is updated by adding a number to its present value as long as the result does 
not exceed a specified maximum value (maximum value is 999). 


The format of the SETCGLOB CLIST is: 


where: 

varname specifies the common global variable whose value is to be 
updated. The name of the variable is given here without using 
the initial ampersand (&). : 

value specifies the new value that is to be assigned to the specified 
common global variable. 

Usage Note 


Only those operators whose operator IDs have been authorized may use SETCGLOB 
CLIST. The list of authorized operator IDs is set up in the NetView initial CLIST by 
setting the common global variables CGAUTHID1, CGAUTHID2, and so on, to the desired 
operator IDs. 


SETCGLOB CLIST depends on using a message automation member to invoke the 
PPTSETCB CLIST based on the message that is sent to the PPT by this CLIST. 


Example 


The following example sets the variable “&TASKCOUNT” to a value of 1. 


SETCGLOB TASKCOUNT TO 1 


Response 


A return code is set upon completion of SETCGLOB CLIST. If invoked from another 
CLIST, this return code can be accessed in the variable “&RETCODE” and may have 
one of the following values: 


0 The common global variable was set as requested. 

8 The operator that issued the CLIST is authorized to use SETCGLOB. 
12 No operators are authorized to use SETCGLOB. 

16 PPT did not respond to the request. 

20 No variable name was specified or no value was specified. 

24 The GO command interrupted the wait for PPT to respond. 
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STACK 


The STACK command suspends a CLIST while it is in PAUSE or WAIT status so that 
commands or CLISTs can be entered. This command also causes commands and 
CLISTS that were stacked because of the original CLisT to execute immediately and 
in the order entered. 


The format of the STACK Command is: 
STACK 


Usage Note 


The effect of a STACK command during a CLIST WAIT is slightly different from its effect 
during a CLIST PAUSE. When a CLIST WAIT is followed by a STACK command, messages 
are still intercepted by the wait processing. This means that messages resulting 
from commands entered after STACK may be intercepted by the suspended CLIST 
and processed by the CLIsT after an UNSTACK command is entered. In other words, 
during CLIST WAIT the processing of stacked messages is deferred until the CLIST is 
reinstated by the UNSTACK command. Any GO command will be rejected. 


Example 


To begin a STACK command, type: 
STACK 


Response 


If the STACK command is successful, the following message will be issued: 
DSI2301I STACK STARTED 


The stack command will not work in session monitor or hardware monitor. It will 
only work on command facility. 
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START 


With the START command you can start: 


¢ a hard-copy log 


e aterminal in recovery status 
e asession between the entering operator and another domain 


¢ an optional task 


¢ a span (add it to an operator’s span of control) 


¢ aresource within a span. 


The format of the START command is: 


START 


where: 


OP = operid 


HCL=hclname 
DOMAIN = domainid 


TERM = terminalname 


SPAN =spanname 


OP = operid 


OP=ALL 
LOGMODE = logmodename 
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OP=operid 
HCL=helname — | 

[,oP = {operid|*’|ALL}] 
[,LOGMODE = logmodename] 
- DOMAIN = domainid 

[ ,LOGMODE = logmodename| 
TERM = terminainame — 
-SPAN=spanname — 
[,OP = {operid|"}] 
_| RESOURCE = resname_ a 
oe Gian ={tasknamelosiLoclOsiPRriDsmRACE} eae 


tells the system to re-establish a terminal in 
recovery status. You can use OP=operid if you 
know the operator ID and not the terminal name. 


tells the system to start a hard-copy log for the 


. specified operator or operators. 


tells the system to start a session between the 
entering operator and the named domain. 


tells the system to restart the session in recovery 
status between the named terminal and the associ- 
ated operator. You use TERM=terminalname if you 
know the terminal name and not the operator ID. 


tells the system that the named span is to become 
part of an operator’s span of control. 


optionally tells the system which operator's span 
or hard-copy log is to be started. 


if omitted or entered as two single apostrophes (“’), 
starts your own span. This is the default. 


starts hard-copy logging for all operators. 


tells the system the logmode entry indicating the 
desired session bind operands. lf not specified, 
the logmode name will default to the logmode 


name on the DLOGMOD entry coded on the APPL 


RESOURCE = resname 


TASK = taskname 


TASK = DSILOG 
TASK = DSITRACE 
TASK = DSIPRT 


Usage Note 


statement. If used with the hard-copy log, this is 


the printer logmode. 


tells the system to make the named resource 


available to this NetView (such as a terminal). 


When NetView is first started, all defined 


resources are available to NetView. Span of 


control is checked. 


tells the system to activate the named optional 
task. The TASK operand and its values are scope 


checked. 


tells the system to activate the network log task. 


tells the system to activate the trace log task. 


tells the system to activate the network log or trace 


log print task. 


You can use the START RESOURCE command to start a resource within a span. Since 
all resources in a span are started when the system is started, use START RESOURCE 
only if you had to use STOP RESOURCE first. 


When a resource is started, the system will not implicitly route a command to 


another domain, even if the resource was also assigned to another domain during 
installation. You can use the START RESOURCE Command to change implicit routing 


to your own domain after a STOP RESOURCE has changed the implicit routing to 


another domain. 


Scope checking is done on the START command and on the TASK operand. 


Example 


To restart terminal NRN14210, enter: 


START TERM=NRN14210 


Response 


You will see a message similar to: 
DSIO401I NRN14210 SESSION RESTARTING FOR OP1. 
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STARTCNM 


The STARTCNM CLIST starts the following tasks: . 
e Hardware monitor — BNJDSERV and BNJMNPDA 


e Session monitor — AAUTSKLP, DSIAMLUT, AAUTCNMI, and the first five characters of 
the host identifier concatenated with the characters LUC 


e Status monitor — the first five characters of the host identifier concatenated 
with the characters vMT, and the first five characters of the host identifier con- 
catenated with the characters BRW 


e 4700 support facility — BNJDSE36 (MVS and VSE) 
e Network log task - DSILOG 
e Trace log task - DSITRACE 


® CNM router task - DSICRTR. 


The format of the STARTCNM CLIST is: 


where: 

ALL starts the browse, hardware monitor, session monitor, status 
monitor, 4700 support facility, network log, trace log, and CNM 
router tasks. 

NLDM _ starts the session monitor tasks. 

NPDA starts the hardware monitor tasks. 

STATMON starts the status monitor and log browse facility tasks. 

TARA starts the 4700 support facility tasks (MVS and VSE). 

NETLOG starts the network log task. 


TRACELOG starts the trace log task. 

Usage Note 

The STARTCNM CLIST Cannot run under the PPT. 

Example 

If the browse facility, hardware monitor, session monitor, status monitor, 4700 


support facility, network log, and trace log tasks have not already been started, you 
could use the following command to start these tasks: 


STARTCNM ALL 


3-158 NetView Operation 


STARTDOM 


The STARTDOM CLIST starts cross-domain communications between the operator 
entering the CLIST and the domain entered. If you use STARTDOM to start a session 
over a switched line and the line has not been dialed, STARTDOM performs the dial 
before establishing the session. 


The format of the STARTDOM CLIST is: 


-STARTDOM domainid = 


where: 

domainid specifies the name of the domain with which you want to start a 
session 

Usage Notes 


The domainid must be a valid VTAM resource name. 


The domainid must be defined to the host at which the CLIST is executed with an RRD 
system definition statement. 


The link station name and CDRM name must be provided as common global vari- 
ables if a dial is to be performed over a switched line. The SETADIAL CLIST, which 
must be run under the PPT, should be used to set these variables. The format of the 
SETADIAL CLIST is: 


SETADIAL domainid linkname cdrmname 

For more information on SETADIAL, refer to the NetView /nstallation and Adminis- 
tration Guide. 

Example 


STARTDOM CNMO1 
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STATIONS 


The STATIONS CLIST displays the status of all cross-subarea link stations within each 
node or for a specific node. 


The format of the STATIONS CLIST is: 


where: 


node__ specifies the name of a node. If this operand is omitted, information is dis- 
played about all link stations in every active node. 


Act displays information about all active cross-subarea link stations within 
each node or a specific node. 


ALL displays information about all cross-subarea link stations within each node 
_oraspecific node. This is the default. 


Inact displays information about all inactive cross-subarea link stations within 
each node or a specific node. 


Usage Note 


This CLIST generates the following VTAM command: 
DISPLAY STATIONS 


The STATIONS CLIST has been changed for release 2 to include await. It will not run 
commands under PPT. 


For more information on this command, see VIAM Operation. 
Example 


To display all the link stations, use the following: 
STATIONS 


Response 


You will see a display similar to: 


TSTO97I DISPLAY ACCEPTED 

IST3501 VTAM DISPLAY - DOMAIN TYPE = STATIONS 

IST393I PU T4/5 MAJOR NODE ISTPUS, SUBAREA=1 

IST3961I LNKSTA STATUS CTG GIG ADJNODE ADJSA NETID 
IST397I OCF-S ACTIV----I 1 1  NCPLOC1 107 

IST6101 LINE OCF-L - STATUS ACTIV----I 
IST3141 END 


The name of the physical unit is istpus, the subarea address is 1, the link station 
name is ocr-s, the status is ACTiv----I, the current transmission group (CTG) number is 
1, and the defined transmission group number (GTG) is 1. 
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STATUS 


The STATUS CLiST displays information on VTAM status codes and status modifiers. 


The format of the STATUS CLIST is: 


STATUS code 


where: 


code __is the status code, or, optionally, the status modifier. 
Usage Note 


This command is not allowed if NetView is installed with the DASD Conservation 
Option. (See “DASD Conservation Option” on page 2-8.) 


Example 


To receive an explanation for the status code ACTiv----Y, enter: 


Response 


You will see information similar to the following: 


CNMAAC IV ACTIV 
State Category Resource State Name and Expianation 
ACTIV Final The resource and session are in the 


active state. Active terminals with 
no active or pending-active sessions 
will have ACT-NOSESS status in 
response to DISPLAY TERMS. 


PF1 ---> Help on Status Modifiers 


It 
It 
I 


Action > 


PF1= Help PF2= End PF3= Return | 
PF6= Rol | PF7= Backward PF11= Entry Point 


Figure 3-9. Status Codes and Modifiers Panel 


Press PF1 for an explanation of the status modifier ----Y. 
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STOP 


With the STOP command you can stop: 


e a hard-copy log 

¢ aterminal in recovery status 

¢ asession between the entering operator and another domain 
~® an optional task 

e aspan (delete it from an operator’s span of control) 

¢ aresource within a span. 


The format of the STOP command is: 


where: 


OP = operid tells the system to end the session between the 
specified operator and the associated terminal. 
The task must be in recovery status. The operator 
must log on again to re-establish the session. 


HCL=hclname is the current name of the hard-copy log task you 
want to end. 


DOMAIN = domainid tells the system to end the cross-domain session 
between the specified domain and the local 
domain. 


TERM = terminalname tells the system to end the session between the 
specified terminal and the associated operator. 
The task must be in recovery status. You must log 
on again to re-establish the session. 


SPAN =spanname tells the system to take the span list (spanname) 
out of an operator’s control. 


OP = operid tells the system which operator’s span is to be 
stopped or to end a session with the hard-copy log 
and an operator. 


OP=*’ If omitted or entered as two apostrophes (‘’), stops 
your own span or ends your hard-copy log ses- 
sions. This is the default. 


OP = ALL ends all connections with the named hard-copy 
log. 
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RESOURCE = resname tells the system to make the named resource una- 
vailable to this NetView (such as a terminal). Span 
of control is checked. 


FORCE = taskname indicates which task is to be deactivated. If you 
use the PPT task identifier, the system will end with 
a user abend code of 8. 


FORCE = hcilname indicates which hard-copy log is to be deactivated. 
FORCE = nntname indicates which NNT is to be deactivated. 
FORCE = terminalname indicates which terminal session with NetView is 


to be deactivated. 


FORCE = DSILOG specifies to deactivate the network log task. You 
should not use this command if the network log 
has an active data set. Use SWITCH DSILOG,T first 
and then wait for message Dsi545! before entering 
the STOP FORCE command. 


FORCE = DSITRACE specifies to deactivate the trace log task. You 
should not use this command if the trace log has 
an active data set. Use SWITCH DSITRACE,T first and 
then wait for message Dsi5451 before entering the 
STOP FORCE command. 


TASK= taskname indicates which DST or optional task is to be deacti- 
vated. STOP TASK does not force an abend but 
attempts to terminate the task in a normal manner. 


Usage Note 


Use the STOP FORCE command to force a task to be ended in cases of extreme 
necessity. The STOP FORCE command should not be issued immediately after the 
STARTCNM Command, that is, before initialization has completed. The tasks can 
then be recovered with the START TASK command if the task was a data services 
task or optional task. The operator can log on again if the task was an operator 
task. Hard-copy tasks can be restarted using START. 


If you are a VM user, the ABEND13E resulting from a stop force is normal. 


The STOP FORCE command should not be used to stop VSAM DST tasks (AAUTSKLP, 
BNJDSERV, BNJDSE36, DSILOG, or DSITRACE). If this command is used on this type of 
task, an unusable VSAM file may result, which would then require the data base to 
be redefined, and NetView to be restarted. It is recommended that the STOPCNM 
CLIST be used to stop any of these tasks. 


lf you issue the STOP FORCE command for DSILOG or DSITRACE, and logging is in 


process, it may take a few minutes before the task is ended, even after you receive 
the following message: 


DSI531I taskname: description IS TERMINATING 
Scope checking is done on the stop command and on the FORCE operand. 
Example 


To stop your hard-copy logging sessions, enter: 
STOP HCL=NRN1520A 
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Response 


You will see a message similar to: 
DSTO561 NRN1520A SESSION STOPPING FOR OPER1. 
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STOPCNM 


The STOPCNM CLIST stops the following tasks: 


Hardware monitor — BNJDSERV and BNJMNPDA 


Session monitor — AAUTSKLP, DSIAMLUT, AAUTCNMI, and the first five characters of 
the application identifier concatenated with the characters Luc 


Status monitor — the first five characters of the application identifier concat- 
enated with the characters vmT, and the first five characters of the application 
identifier concatenated with the characters BRW 


4700 support facility — BNJDSE36 (MVS and VSE) 
Network log task - DSILOG 


Trace log task - DSITRACE. 


The format of the STOPCNM CLIST is: 


STOPCNM ALL 
NLDM 
NPDA 
‘STATMON 
TARA 
NETLOG 
TRACELOG 
where: 
ALL stops the browse, hardware monitor, session monitor, status 
monitor, 4700 support facility, network log, and trace log tasks. 
NLDM stops the session monitor tasks. 
NPDA stops the hardware monitor tasks. 


STATMON stops the status monitor and log browse tasks. 


TARA stops the 4700 support facility tasks (Mvs and VSE only). 


NETLOG stops the Network log task. 
TRACELOG _ stops the trace log task. 


Usage Note 


Check with your system programmer before using this CLIST. It is recommended 
that this CLIST be scope-checked. 


It is recommended to use the STOPCNM CLIST when terminating a VSAM DST (NETLOG or 
TRACELOG. ) 


The CNM router task (DSICRTR) is not affected by STOPCNM. 


This CLIST should not be executed until the ‘DST IS READY’ message has been 
received. 


The STOPCNM CLIST cannot run under the PPT. 
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Example 
Use the following command to stop browse facility, hardware monitor, session 


monitor, status monitor, 4700 support facility, network log, and trace log tasks. 
STOPCNM ALL 
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SWITCH 


The SWITCH command allows you to specify or control access to either the primary 
or the secondary network log or trace log, or switch control of the DST tasks. 


The format of the SWITCH command is: 


SWITCH taskname 


{,P|,S|,T} 
DSILOG 


{,P|,S|,T} 
DSITRACE 


(PIS|T} 


where: 


taskname is the one- to eight- character name of the data services task (DST). 
You can get this name by using the LIST command. 


DSILOG the name of the network log task. 
DSITRACE the name of the trace log task. 


P means you want the primary VSAM file made active. Access to the 
secondary network/trace log ends. 


S means you want the secondary VSAM file made active. Access to 
the primary file ends. When switching files, active requests are 
completed. New requests are sent to the secondary file. 


T means that access to the currently active VSAM file, primary or sec- 
ondary, should end after the current requests are complete. New 
requests are rejected. 


Usage Note 


Use this command to make the primary or secondary file the active network/trace 
log. You should use this command when errors prevent your access to the primary 
file and may permit continued operation on the secondary file. When you switch 
network/trace log files, active requests are completed. 


For the data base associated with the hardware monitor, use task name BNJDSERV. 


For the data base associated with the session monitor, use task name AAUTSKLP. 
Session data is logged to VSAM by the session monitor at various times during a. 
session. Switching the session monitor data base between the primary and sec- 
ondary VSAM files could cause a session's data to become divided between the two 
VSAM files. Dividing a session’s data may give unpredictable results when trying to 
display data that is not on the active vsam file. 
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The switching to T is not recommended for hardware monitor and session monitor 
data bases. 


Scope checking can be done on the SWITCH command. 


Example 


To switch to the primary network log, enter: 
SWITCH DSILOG, P 
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SWLOG 


The SWLOG CLIST switches the files for the network/trace log or stops a file from 
being used. 


The format of the SWLOG command is: 


SWLOG  {LOG|TRACE} {PjsiT} 


where 

Log indicates network logs. 

Trace indicates trace logs. 

P prints primary log. 

Ss prints secondary log. 

T means to end processing with the active VSAM file after current requests 
have completed. New requests are then rejected. 

Usage Note 


For more information, see “SWITCH” on page 3-167. 
Example 


If you are encountering errors on the primary network/trace log file, you can 
change to the secondary network/trace log file by using the following command: 


SWLOG $ 
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TERMS 


The TERMS CLIST displays the status of all device-type logical units (terminals) in 
active major nodes. 


The format of the TERMS CLIST is: 


where: 


Act displays information about all active terminals in active major nodes. 


ALL displays information about all terminals in active major nodes. This is the 
default. 


Inact displays information about all inactive terminals in active major nodes. 
Usage Note 


In a domain that has many terminals, this CLIST may result in an undesirably long 
display, especially if the ALL operand, which is the default, is used. 


This CLIST generates the following VTAM command: 
DISPLAY TERMS 


For more information on this command, see VTAM Operation. 
Example 


To display all the inactive terminals, use the following command: 
TERMS INACT 


Response 


You will see information similar to the following: 


IST3501 VTAM DISPLAY - DOMAIN TYPE = LOGICAL UNITS/TERMS 
IST3541 PU 14/5 MAJOR NODE = ISTPUS 

IST3511 LOCAL 3270 MAJOR NODE = H21L 

ISTO89I H21L420 TYPE = LOGICAL UNIT » NEVAC » CUA=420 
TSTO89I H21L42B TYPE = LOGICAL UNIT > NEVAC » CUA=42B 
IST3521 LOCAL SNA MAJOR NODE = H215S 


For each major node with terminals, you may see the following: 


¢ The major node name (for example, ISTPUS, H21L, H21S) 

e The line name and status (if the terminal is attached over a line) 
e The name and status of the associated physical unit 

¢ The name and status of the logical unit (for example, H21L420). 


3-170 NetView Operation 


THRESH 


The THRESH Command displays or changes the current threshold value for stations 
attached to 3710s and NCPs. 


The format of the THRESH command is: 


THRESH ID=resname 


| )STATION= resname ay 
[QUERY ee 
| PT= thrvalue } ae 
|.,toT=thrvalue | 
| .TeT=thrvalue |. 

_ | RoT=thrvalue | 
ee ne =thrvalue _ Pag ee 


where: 
iD=resname is the network name of the node to which the station attaches. 


STATION=resname is the network name of the station attached to the node identi- 
fied by the value of the ID operand. 


QUERY displays all thresholds for the peeqee station. This is the 
default. 


Use the following operands to specify a new threshold value for stations attached 
to an NCP. ‘ 


TDT =thrvalue when the station is an SNA device attached to an ncpP, this \ 
number means “total transmissions” threshold. 


For BSC devices attached to an NcP, the number represents the 
“traffic count” threshold. The value of this operand must be a 
decimal number in the range from 1 to 65535. 


TET =thrvalue for SNA stations attached to an NcP, this number reflects a “total 
retries” threshold, and the value of this operand must be a 
decimal number in the range of 1 to 65535. 


If the station is a BSC device attached to an NcpP, this threshold 
value represents an “error count” threshold, and the value of 
this operand must be a decimal number in the range of 1 to 255. 


For the 3710, the specified threshold value must be a decimal integer from 0 to 
65535. If you specify a threshold value of 0, the 3710 stops counting and sending 
traffic statistics for the kind of threshold indicated. Use the following operands to 
specify a new threshold value for stations attached to a 3710: 


PT =thrvalue specifies a new poll threshold for a station. Poll threshold 
applies only to SNA devices off the 3710. 


TDT =thrvalue specifies a new transmit data threshold for a station. 
TET =thrvalue specifies a new transmit error threshold for a station. 


RDT =thrvalue applies to 3710s only and specifies a new receive data threshold 
for a station. . 
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RET =thrvalue applies to 3710s only and specifies a new receive error 
threshold for a station. 


Usage Note 
You can change only one threshold value at a time. 


When you specify the ID name as an NCP name with a particular station name, you 
are setting or displaying the threshold values kept by the ncpP for the station. When 
you specify the iD name as a 3710 name with a particular station name, you are 
setting or displaying the threshold values kept by the 3710 for the station. 


Scope checking can be done on the THRESH command. 
Example 


To display the threshold values for NYC3710 attached to NCP1, use the following 
command: 


THRESH ID=NCP1,STATION=NYC3710, QUERY 
Response 


You will see information similar to: 


DS13321 THRESHOLD DISPLAY FOR ID=NCP1 AND STATION=NYC3710 
DSI334I PT=number TDT=number TET=number RDT=number 
DS1334I RET=number 

DSI333I END OF THRESHOLD DISPLAY 


The number is a decimal integer giving the threshold value. For all non-SNA 


devices, the PT value will be displayed as an asterisk (*), since there is no poll 
threshold value for them. 
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TNSTAT 


The TNSTAT CLIST changes, restarts, or stops the recording of tuning statistics. 
Tuning statistics can be used to gather data for adjusting VTAM and NCP variables to 
improve performance. 


The format of the TNSTAT CLIST is: 


TNSTAT  [OFF]|[NO|YES[time|10]] 


where: 
OFF stops the recording of tuning statistics. 


NO sends the tuning statistics to the SMF network log (Mvs) or to an external 
CMS file (vm). This is the default. 


YES sends the tuning statistics to the system console as well as to the SmF data 
set (MVS) or to an external CMS file (VM). 


time specifies the number of minutes between tuning statistics recording 
events. This number can be a value from 1 through 1440. If not specified, 
the default is 10. 


Usage Note 


Before you can use the tuning statistics facility, the TNSTAT start option must have 
been specified when VTAM was started. This CLIST generates one of the following 
VTAM commands: 


MODIFY NOTNSTAT 


MODIFY TNSTAT 


For more information on these commands, see VTAM Operation. 


If you omit a positional operand, you must indicate its absence by a comma. If you 
do not specify any operands, the default is TNSTAT NO. 


Example 


To start the recording of tuning statistics, use the following: 

TNSTAT 

Then to stop the recording of the tuning statistics, use the following: 
TNSTAT OFF 
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TRACE 


The TRACE command itnitiates a sequence trace that records, either in virtual 
storage or On DSITRACE, a sequence of NetView processing steps. This can help 
you solve problems you may encounter using NetView. 


The format of the TRACE command is: 


where: 


ON 


OFF 
END 


OPTION 
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turns the indicated options on. ON is the only correct choice if the 
NetView trace is inactive. 


turns the indicated options off. 


indicates that all tracing is to stop and internal trace storage is to 
be freed. No other operands can be specified with the END 
operand. If other operands are specified, the command will be 
rejected with an error message. 


indicates which trace options will be traced. Each option identi- 
fies an internal event type that is to be traced. 


The OPTION operand is optional. If it is not specified on the initial 
trace activation command (the NetView internal trace is not active 
before you issue this command), the options QUE, PSS, DISP, and 
STOR will be traced. 


If OPTION is not specified on later TRACE commands, the previous 
active options will be used as the options values. This enables 
you to turn off and on all trace options. TRACE OFF without an 
OPTION operand will turn off all options currently being traced, 
because the previously active TRACE options are assumed. Then, 
by issuing TRACE ON without the OPTION operand, those same 
options will be reactivated. 


The options are as follows: 
e ALL—indicates all options 
e¢ QUE—indicates inter-task queueing of buffers using DSIMas 


¢ PSS—indicates presentation services, which involves input 
from and output to the terminal screen using DSIPSS 


e DIiSP—indicates dispatching of tasks including waiting 
(DSIWAT), post (DSIPOS), and dispatch from a wait (resumption 
of processing from DSIWAT) 


e STOR—indicates getting and freeing of storage. 


e UEX!IT—indicates user exit calls for DSiIEx01 through DSIEX15, 


plus CNM Interface INPUT EXIT, CNM Interface OUTPUT EXIT, DST INIT 
EXIT, VSAM INIT EXIT, VSAM INPUT EXIT, VSAM OUTPUT EXIT 


e MOD—indicates module entry and exit trace of a subset of the 
command facility modules. 


MODE = INT indicates to log the trace data in the internal table. 


MODE = EXT indicates to log the trace data on the trace log. MODE=ExT will be 
rejected if the DSITRACE task is not active or if there are no VSAM 
clusters active when the trace command is processed. 


SIZE = indicates how many pages of storage to allocate for in-storage 
trace table. This operand is optional. If MODE=INT, the default 
size is 2 pages. 


Usage Note 


The TRACE command may be scope checked, but the operands are not scope 
checked. 


If the trace to VTAM is successful but the trace to NCP is rejected, the trace display 
indicates that the resource is being traced, but it will have incomplete trace data. 


Specify the MODE operand on the initial trace activation command only. If specified 
at other times, either a warning or error message will be issued. This operand is 
not optional. The default value is ExT unless the SIZE operand is specified. If size is 
specified but MODE is not, then MODE=INT is implied. MODE=EXT and SIZE are mutu- 
ally exclusive options. SIZE will be ignored if MODE=ExT is specified. 
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TRANSMSG 


The TRANSMSG command loads a set of National Language message translations 
defined in a member of DsiMsG into NetView. The command can be issued suc- 
cessfully only once at each NetView initialization. It is recommended that this 
command be placed in your NetView initial CLIST. 


The format of the TRANSMSG command is: 


_TRANSMSG_ MEMBER={member-name} 


where: 


member-name is the name of the data set member in DSIMSG containing the 
| National Language message translations. 


Usage Note 
The name must not be prefixed with Ds. 
TRANSMSG is available only for Mvs/xA and only with the DBcs feature. 


Example 
TRANSMSG MEMBER=JAPANMSG 


Response 


R15 return code = 0 (reflected in variable &RETCODE when invoked by a CLIST). 
Message translations have been loaded into NetView successfully. 


¢ Normal Completion Message 


CNM257I MESSAGE TRANSLATIONS HAVE BEEN LOADED FROM DSIMSG MEMBER 
membername 
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wvs TSOUSER 


The TSOUSER CLIST displays the status of a TSO user ID. 


The format of the TSOUSER CLIST is: 


TSOUSER id 


where: 


id is the TSO user ID about which information is to be displayed. 
Usage Note 


This CLIST generates the following VTAM command: 
DISPLAY TSOUSER 


For more information on this command, see VTAM Operation. 
Example 


To find out the status of TSO user TSO21, use the following command: 
TSOUSER TS021 


Response 


You will see information similar to the following: 


TST097I DISPLAY ACCEPTED 

TSTO751T VTAM DISPLAY - NODE TYPE = TS0 USERID 

IST4861 NAME= TSO21, STATUS= DSCNT, DESIRED STATE=N/A 
IST5761 TSQ TRACE=OFF 

TST2621 APPLNAME = TSO00G1, STATUS = ACTIV 

I872621 LUNAME = L3E6G, STATUS= ACT/S 

TST3141 END 


This example shows the TSO user !D as TSO21 with a status of DSCNT, the TSO trace is 
not active, the application name associated with the TSO user space is TSO0001, and 
the logical unit being used is L3E0. 
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TUTOR 


The TUTOR CLIST displays the panels that the system programmer has entered into 
the CNMPNL1 library (MVS) or the file with filetype NCCFLST (VM). 


The format of the TUTOR CLIST is: 


where: 


panelname specifies the panel to be displayed. 

Usage Notes 

If you receive a nonzero return code, an error message will be displayed. 
This CLIST is usually called from another CLIsT to display online help panels. 


If you get to a help panel by using TUTOR, the PF keys on that panel indicated as 
active (by their colors or highlighting) may not be accurate. 


This command is not allowed if NetView is installed with the DASD Conservation 
Option. (See “DASD Conservation Option” on page 2-8.) 


Example 


To look at screen CNMKNEEO that the system programmer has written and placed in 
the CNMPNL1 library, use the following command: 


TUTOR CNMKNEEO 
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UNSTACK 


The UNSTACK Command Causes a CLIST suspended by STACK to continue processing 
in the WAIT or PAUSE state. 


The format of the UNSTACK command is: 


_ UNSTACK 


Usage Note 


When the STACK command is used for a CLIST in a timed wait, the timed wait con- 
tinues. However, the CLIST cannot recognize a time out and resume processing 
until the UNSTACK command is issued. If UNSTACK is issued before a timed wait 
expires, the timed wait continues as if it had never been interrupted. If UNSTACK is 
issued after a timed wait expires, the CLIST will resume processing as if the time 
out had occurred at the time the UNSTACK command was issued. 


Example 


To issue the UNSTACK command, type: 

UNSTACK 

if the UNSTACK Command is successful, the following message will be issued: 
DSI5861 CLIST clistname IS RESUMED 


If an UNSTACK command is entered without having first entered a STACK command, 
or if the UNSTACK command is entered at a different linkage level from the corre- 
sponding STACK command, one of the following error messages will be issued: 


DS12311 NO STACK IS ACTIVE 
DSI2331 STACK IS NOT ACTIVE AT THIS LEVEL 


For example, suppose you have entered a STACK command. Then you enter a com- 
pound command processor or another CLisT. Before you can successfully enter an 
UNSTACK Command you might have to end the compound command processor or 
CLIST. If you are unsure what level you are at, enter UNSTACK anyway. If you are at 
the right level it will work. If not, you will get the error message and you can end 
the current compound command processor or CLIST and try again. 


Note: UNSTACK works from all NetView-supplied compound command processors. 
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UPDCGLOB 


The UPDCGLOB CLIST sends a message to the NetView ppt task to request that a 
specified common global variable should be updated. The variable’s value is 
updated by adding a number to its present value as long as the result does not 
exceed a specified maximum value (maximum value is 999). 


The format of the UPDCGLOB CLIST is: 


where: 

varname specifies the common global variable whose value is to be 
updated. The name of the variable is given here without using 
the initial ampersand (&). 

increment specifies a number to be added to the variable’s current value in 
order to determine a new value for the variable. 

maxvalue specifies the maximum value you want to allow the variable to 
take. 

Y 
Usage Note 


Only those operators whose operator IDs have been authorized may use UPDCGLOB 
CLIST. The list of authorized operator IDs is set up in the NetView initial CLIST by 
setting the common global variables CGAUTHID1, CGAUTHID2, and so on, to the derived 
operator IDs. 


UPDCGLOB CLIST depends on using a message automation member to invoke the 
PPTSETCB CLIST based on the message that is sent to the PPT by this CLIST. 


Example 


The following example requests the PPT to update the common global variable 
“&TASKCOUNT” by 1. If &TASKCOUNT was formerly set to 20, it will be changed to 21. 


UPDCGLOB TASKCOUNT BY 1 MAX 55 
Response 
A return code is set upon completion of UPDCGLOB CLIST. If invoked from another 


CLIST, this return code can be accessed in the variable “&RETCODE” and may have 
one of the following values: 


0 The common global variable was set as requested. 

4 The updated value would have exceeded the specified maximum. 
8 The operator that issued the CLIST is authorized to use UPDCGLOB. 
12 No operators are authorized to uSe UPDCGLOB. 

16 PPT did not respond to the request. 

20 No variable name was specified or no value was specified. 

24 The GO command interrupted the wait for PPT to respond. 


NN 
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VRST 


The VRST CLIST displays the meaning of the virtual route status. 


The format of the VRST CLIST is: 
VRST Status 


where: 


status is the virtual route status code. 
Usage Note 


This command is not allowed if NetView is installed with the DASD Conservation 
Option. (See “DASD Conservation Option” on page 2-8.) 


Example 


To display the meaning of virtual route status BLOCK, type: 


Response 


The following screen appears: 


CNMOVRBK VR BLOCKED STATUS DESCRIPTION 


_- BLOCKED : the VR is in hold waiting for pacing response. 


Eo” BP He ip” PF2= End  PF3= Return — ee eee 
oo PF6= Roll PF7= Backward = PF T1= Main Menu 


Figure 3-10. Virtual Route Status 
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WHO 


The WHO CLIST lists the status of all operator terminals, NetView-NetView task ses- 
sions requested by other NetViews, and information about your session. 


The format of the WHO CLIST is: 


Response 


After entering the WHO CLIST, you will see information similar to: 


* NCFO1 WHO 
C NCFOQ1 LIST STATUS=OPS 
OPERATOR: OPERI TERM: AQ1A441 STATUS: ACTIVE 
END OF STATUS DISPLAY 
C NCFOL LIST STATUS=NNT 
NCFO1 MAX SESS: 80000005 
NO ACTIVE NCCF TO NCCF SESSIONS FOUND 
C NCFOQ1 LIST ° 
- NCFOl STATION: OPERI TERM: AQ1A441 
HCOPY: NOT ACTIVE PROFILE: PROFSEC 
STATUS: ACTIVE 
DOMAIN LIST: NCFQ1 (I) NCF11 (1) NCF12 (1) 
NCF13 (1) NCFI4 (1) NCFi5 (1) 
ACTIVE SPAN LIST: NONE 
END OF STATUS DISPLAY 
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WRAP 


The WRAP CLIST changes the setting of AUTOWRAP. If AUTOWRAP is on, thiS CLIST turns 
it off. If AUTOWRAP is off, this CLIST turns it on. 


The format of the WRAP CLIST is: 
WRAP 


Usage Note 
If you use the WRAP CLIST more than once, it will alternate between setting AUTOWRAP 


0 and turning AUTOWRAP off. Results will be unpredictable if you use the WRAP CLIST 
together with the AUTOWRAP command. 
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Chapter 4. Getting Acquainted with the Hardware Monitor 


Data Collection 


Solicited Data 


Unsolicited Data 


Many hardware resources in a network send information and error records to the 
host system. The hardware monitor (also known as NPDA) collects this information 
and arranges and displays the data to help you with problem determination. You 
can use the hardware monitor to display the most recent events and statistics 
recorded about a network resource. The hardware monitor will analyze error data 
for probable causes and recommend actions to correct the problem. You can use 
filters to keep extraneous information from complicating your problem-solving 
efforts. An alert function informs you quickly of high-priority problems. You can 
also record problems directly into the Information/Management system (see page 
E-1) from the hardware monitor. 


The hardware monitor collects data from many different sources in various formats 
and gives a common structure to this information. This data can be classified as 
solicited or unsolicited data. 


Solicited data is received as the result of a specific request for information or as 
the result of an action that you have taken. Certain SNA control units keep counters 
of different types of communication errors they detect and transmit the counters to 
the host only as solicited data. 


Unsolicited data is received without any action on your part. Unsolicited data may 
be received as the result of an error being detected in the network, or whenever 
error or traffic counters are exceeded and the network control program (NCP) sends 
collected data to the hardware monitor. Unsolicited data may be recorded as 
either an event or a statistic. Statistics are records of traffic volumes and tempo- 
rary errors. Events can be records of permanent errors or of other unusual occur- 
rences and may also come from statistics that qualify for event status because of a 
high ratio of temporary errors to traffic. 


When the hardware monitor receives unsolicited data it creates a record con- 
taining information about the data and stores it as an event or statistical record or 
both in the data base. If the data qualifies as an alert, an alert record will also be 
created. 


See Figure 4-1 on page 4-2 for more information on the hardware monitor data 
collection. 
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Record Types 
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DATA COLLECTED BY HARDWARE MONITOR 


:| Hardware 


HARDWARE 
MONITOR 
DATA 

BASE 


FILTERING 


SOLICITED NETWORK 
SNA EVENT DATA 


@ Terminal! Error 
Counters 


UNSOLICITED DATA 


@ Event Data 
-Permanent errors 


Statistical errors @ Terminal EC Level 
-Temporary errors 
-Traffic volume @ Link Level Test 


Results 


Alert Data 
-Events requiring 
Immediate action 


@ 386x Modem Status 
@ 586x Modem Status 


@ 383x Modem Status 


Figure 4-1. Data Collected by the Hardware Monitor 


The hardware monitor creates a data base made up of several record types: sta- 
tistics, events, and alerts. 


Statistics are records of traffic and recoverable error counts that have been col- | 
lected at certain resources and reported to the host system. Statistical data gener- 
ated by resources is sent to the host, and the hardware monitor stores these 
records in its data base. For certain resources, the hardware monitor analyzes 
each statistical record to determine whether to create a performance event record, 
which may become an alert. 


A statistic can become an event when it exceeds the limits that you have set as a 
threshold. A threshold is a ratio of temporary errors compared to the traffic associ- 
ated with the resource and is expressed as a percentage. It is meant to indicate 
the least acceptable percentage of temporary errors. If the threshold is exceeded, 
the hardware monitor creates an event record to record this condition; the original 
record is also recorded as a statistic. 


Events are unexpected occurrences in network operation. An event may be 
recorded when the attempted activation of a resource fails. This failure may be 
due to a physical error in the network. Event data detected and generated by 
resources is sent to the host system for the hardware monitor both to store in its 
data base and to determine whether to issue and record an alert. An event can 
become an alert depending on what recording filters you have set. Alerts are 
events that you have decided require immediate attention. As soon as an event 
record is created, the hardware monitor checks the current state of its recording 
filters to see if this event qualifies for alert status. If it does, two things occur: 


e An alert record about the event is written to the hardware monitor data base. 


e A line item is created for presentation to the hardware monitor users on the 
Alerts-Dynamic panel if their viewing filters are set to pass an event of this 
type from this resource. These users’ screens are automatically updated to 
reflect the occurrence of this special event. They may then take immediate 
action as called for by the nature of the event and any pertinent local proce- 
dures. 


An alert appears on your screen as a one-line summary of the event that shows the 
error description and probable cause. The hardware monitor may also issue a 
numbered message about the alert to an authorized operator if filters are set up to 
provide this function. 


Events are classified by type. Following is a list of event types and their corre- 
sponding abbreviations and codes. 


Availability AVAL 09 
Customer application generated CUST 05 
Delayed recovery DLRC OF 
Environment ENV OB 
Held alert flag HELD -- 
Impending problem | IMPD 11 
Intensive Mode Recording IMR 08 
Installation INST OC 
Intervention required INTV 04 
Notification of status change NTFY OA 
Performance PERF 03 
Permanently affected resource PAFF 10 
Permanent error PERM 01 
Operational/procedure PROC OD 
Security SCUR OE 
SNA summary SNA 07 
Temporary or recoverable error TEMP 02 
End user generated USER 06 
Unknown | UNKN 12 
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Event types can be used in filter-setting commands to control what types of data 
are recorded in the hardware monitor’s data base or are viewed by a NetView 
operator. See SRFILTER and SVFILTER for more information on filter setting. 


Terminology 


To make the best possible use of the hardware monitor, you should know your 
system configuration. That is, you must Know how the different components in your 
system or network are connected to each other and to the host controller. You 
should also understand how the hardware monitor sees your configuration, 
because the probable cause terminology used by the hardware monitor may be 
unfamiliar to you. 


Figure 4-2 gives you more information on how the hardware monitor's physical 
components and levels are related to each other in one typical configuration. 


Host (CPU) 


Communication 
Controller Various 


(COM C) Modems Coaxial Devices: 
ate renee enter erar tard aca crenaterare f Cables free ie 


come , 


Local Remote 
(Primary) (Secondary) 


Channel 


Figure 4-2. The Hardware Monitor Physical Components and Levels 


Some of the abbreviations that the hardware monitor uses are explained in the fol- 
lowing: 


COMC Communication controller—such as 3704, 3705, or 3725. 


CPU Central processing unit—the host computer. 
LINE The communication path between the local and remote modems. 
CTRL The cluster controller on the remote end of the line-such as a 3274, 3276, 


8100, or 3777. 
DEV The terminal connected to the cluster controller-such as a 3278, or 8775. 


CHAN Channel-the path between the host processor and a channel-attached 


device. 
LCTL A cluster controller attached to the cpu by the channel. 
LDEV A device attached to a channel-attached cluster controller. 
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Starting the Hardware Monitor 


The hardware monitor usually starts when the NetView program is started. 
However, if your installation chooses to start them separately, NetView must be 
started first. You can then start the hardware monitor by entering: 


STARTCNM NPDA 


Using the Hardware Monitor 


Before you can use the hardware monitor, NETViEW must be active. You can then 
use the hardware monitor by entering the following command: 


NPDA 


The first panel you see is the Menu panel. From this panel you can enter a number 
1 through 7 next to the CMD = = > field. If you would rather not enter one of these 
selection numbers, you can enter an explicit hardware monitor command instead. 


Note: If NetView is installed with the DASD Conservation Option, the only hardware 
monitor commands that are allowed unconditionally are END, REPORTS, REQMS, 
and SRFILTER. The PURGE, PURGEDB, and PRGATT commands can be invoked 
locally only as timer initiated commands to be processed by the ppt. Each of 
these commands must be prefixed with the NPDA command. The NPDA 
command cannot be followed by a hardware monitor command other than 
those just mentioned. 


You must use the hardware monitor SDOMAIN command from a NetView 
which has installed without the DASD Conservation Option to set the hard- 
ware monitor domain to the domain of the NetView host which has installed 
with the DASD Conservation Option prior to entering hardware monitor com- 
mands that are not allowed to be processed at the DASD Conservation Option 
NetView host. 


12/87 1 13: 29: 00° 
A © RALO. 
“PLEI2T 


Figure 4-3. Hardware Monitor Menu Panel 


Chapter 4. Getting Acquainted with the Hardware Monitor 4-5 


Panel Layout 


The panel has seven sections: 


¢ Operator, Date, and Time-Section @ 
¢ Display Number, and Title-Section € 

e Hierarchy and Requested Information-Section © 
¢ Operating Instructions-Section @ 
¢ Operational Information-Section © 
¢ Message Area-Section @ 

¢ Command Entry Area-Section @. 


Refer to the screen above as you read about each section. 


Operator, Date, and Time 
Section ©» contains the operator identifier, date and time. The date and time 
shown are those of the last display update. 


Display Number and Title 
Section ©) contains the display number and title of the display. Each display has a 
number and title. 


Hierarchy and Requested Information 
Section ©) contains the pictorial hierarchy and the information you requested. The 
hierarchy (or configuration data) shows the domain name and resource names and 
types: Note: Hierarchy is not present on all displays. 


Domain is the name of the domain where the data being viewed was collected. 


TYPE1 is the highest level in the hierarchy that is being reported to the hard- 
ware monitor. For instance, this information could be Cpu (for VTAM or MVS), 
COmc (for an NCP), or 8100 (for 8100/pPPx system). 


TYPE2 through TYPES show the connectivity for the failing device. For instance, 
this information could be LINE, CTRL (for a PU), DEV (for a disk or tape). 


RESNAME1 through RESNAMES are the symbolic resource names assigned by your 
installation. If a resource is attached through a complex link (example: 3710), 
some of the hierarchy may not appear on the display. This kind of connection 
is indicated by an * preceding RESNAME1. There will also be a message at the 
bottom of the screen indicating that some of the hierarchy is not present. 


Operating Instructions 
Section @% contains the operating instructions. These instructions (prompts) tell 
you what you can enter from your current display or how to get to the next series of 
displays. 


Operational Information 
Section ©) contains the operational information. This area will display any infor- 
mational or error messages. 
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Message Area 


Section ¢ contains the message area. This area contains any immediate 
message or other data generated by NetView. 


Command Entry Area 
Section ©, contains the command entry area. This line is where you enter your 
hardware monitor request in the form of a selection number or a command. 


Entering Commands 


You can enter commands in several ways. The fourth line from the bottom of the 
display contains a subset of operating instructions (or prompts) for each display. 
These prompts tell you how to get to the next set of panels or indicate the functions 
you are allowed to perform at this stage of problem determination. 


Moving through the Hierarchy 


The following section is a collection of many of the panel types that you will see 
while using the hardware monitor. From any panel display you may issue the HELP 
command for an explanation of data fields and the use of the panel. 


Many hardware monitor panels have several formats depending on what type of 
data is relevant for the particular resource or event. 


The diagram below shows the general relationship of many of the hardware 
monitor panels. You can usually arrive at a specific panel in several ways. You 
may move down the hierarchy of panels, or you may use an explicit hardware 
monitor (NPDA) command, as shown in the left column in Figure 4-4 on page 4-8 to 
go directly to the desired information. 


See Figure 4-4 on page 4-8 for more information on panel flow. 
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Figure 4-4. The Hardware Monitor Panel Hierarchy 
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Menu Display 
Provides a selection of different hardware monitor functions. Shows 
data base initialization dates. It also lets you know which domain you 
are in session with and the domain to which you are attached. 


Alerts-Dynamic Display 
Provides a continuously updated single page of alerts retrieved from 
the data base, presented in reverse chronological order. 


Alerts-Static Display 
identical to the dynamic display, but can hold alerts (take a 
“snapshot” of the Alerts-Dynamic panel) so you can continue to work 
on problems. From this panel, you can also enter a problem in the 
information/Management system. See page E-1 for more information. 
This is a one-page display. 


Alerts-History Display 
Displays all alerts on the data base. This can be a multipage display. 
From this panel, you can also enter a problem in the 
Information/Management system. 


The Information/Management system does not support the printing of 
Kanji characters. Unexpected results may occur. 


Total Events Display 
Provides summary totals of events about specific resources. 


Most Recent Events Display 
Provides a reverse chronological listing of the events on the data 
base for a specified resource. From this panel, you can also enter a 
problem in the Information/Management system. 


Information/Management does not support the printing of Kanji char- 
acters. Unexpected results may occur. 


Recommended Action Display 
Suggests actions you may take either to bypass or to resolve the 
event. This can be a multipage display. 


Event Detail 
Provides a selection of different detail information displays. 


Note: Event Detail menu is available for NMvT record types only. 


Total Statistics Display 
Displays summary of statistical data about specific resources. 


Most Recent Statistics Display 
Provides a reverse chronological listing of the statistics on the data 
base for the specific resource. 


Link Problem Determination Aid . 
Tests initiated by the NCP that provide modem status, attached 
device status, and the overall quality of a communications link. 


Statistical Detail Display 
Provides a list of temporary error counter values recorded for phys- 
ical and virtual links. | 


Command List Display 
Provides details and examples of how to use hardware monitor (NPDA) 
commands. Can also be accessed from the hardware monitor HELP 
menu. 
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Help Menu 
Provides access to help in the use of the hardware monitor. 


Help Display | 
Provides help for terms and prompts seen on the panels. It also pro- 
vides general information on how to use the panels and the hardware 
monitor. 


CTRL Prompt Display 
Describes the CTRL command and prompts you for a resource name. 


CTRL Screen 
Provides link test counts, summary error counts, and release level 
information from the SNA controller retrieved as a result of the CTRL 
command. 


TEST Prompt Display 
Describes the use of the TEST command and prompts for resource 
names. 


TEST Results Panels , 
Display the status of the modems or line or both. Also displays the 
current and transition states of the Electronic Industries Association 
(EIA) leads for a selected remote station. For the line, analog and 
digital parameters are listed. For the Modem and Line Status panel 
and the Link Status and Test Results panel, see page D-1 for accept- 
able receive signal levels. 


4700 Support Facility Panels 
Provide specific information for problem determination with the 3600 
and 4700 Finance Communications Systems. See Figure 4-5 on 
page 4-11 for the hierarchy of panels. 
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Figure 4-5. 4700 Support Facility Panel Hierarchy 


The following is a collection of the panel types that you will see while using the 
information provided on the 4700 support facility. The 4700 support facility includes 
support for the 3600 and 4700 Finance Communications Systems. 

Refer to Figure 4-5 for more information on panel flow. 


Menu Display 
Provides entry into the display sequence by direct selection. 


Display Control Commands 
Gives a brief description of all the 3600 and 4700 display commands. 
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Command Selection 
Gives a brief description of the commands not described in the HELP 
display. 


All Controllers 
Provides a list of all 3600 and 4700 controllers. 


Controller Summary 
Provides information about a specific controller and its attached loops and 
workstations. 


Loop Most Recent Status 
Provides a list of the most recent status changes for the selected controller 
and loop. 


Loop Most Recent Error 
Provides the most recent loop error data for the selected controller and 
loop. 


Workstation Most Recent Response Time 
Provides the most recent response-time measurements for the selected 
controller and workstation. 


For explanations of the fields shown on the panels, see Appendix B, “List of Panel 
Fields” on page B-1. 


Program Function Keys 


The DISPFK command allows you to display the current hardware monitor PF key 
settings. (Ask your lead operator whether your default PF key settings are estab- 
lished.) 


Defaults for the hardware monitor and 4700 Support Facility keys are as follows: 


PF1 HELP Presents online help information for the hardware monitor or 
4700 Support Facility. 


PF2 END Pressing this key causes the system to return to the previous 
component that the operator used. If there was no previous 
component, a message is sent to the operator. 


PF3 RETURN Pressing this key causes the system to return to the point 
where this panel was requested. If the point where this panel 
was requested is another component, and no previous hard- 
ware monitor screen data will be lost, then this key functions tn 
the same way as the END key (PF2). 


PF4 TOP For a multipage panel, this displays the first page of the panel. 


PF5 BOTTOM For a multipage panel, this displays the last page of the panel. 
This PF key is not supported by the 4700 Support Facility. 
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PF6 ROLL The system remembers the sequence in which you went from 
one component to another. When you use the ROLL PF key, the 
system saves the name of the current component at the begin- 
ning of this sequence, and re-enters the component at the end 
of the sequence, displaying the panel that was displayed when 
you last left the component. For example, if you enter NPDA, 
followed by NLDM, followed by TARA, the sequence remembered 
is: 


NPDA - NLDM - TARA 


Pressing the ROLL PF key changes the remembered sequence 
to: 


TARA - NPDA - NLDM 


and displays the help panel that was displayed when you left 
the session monitor (NLDM) component. 


Pressing the ROLL PF key again changes the remembered 
sequence to: 


NLDM - TARA - NPDA 


and displays the panel that was displayed when you left the 
hardware monitor (NPDA) component. 


PF7 BACK For a multipage panel, this displays the previous page of the 
panel. 


PF8 FORWARD For a multipage panel, this displays the next page of the panel. 
PF9 COPY Prints a copy of the page being displayed. 
PF10 DISPFK Displays the current PF key settings. 


PF12 RETRIEVE Places the previous command (except session monitor com- 
mands) in the command area. 


Online Help Information 

To get online help for the hardware monitor, enter: 

HELP NPDA 

Note: This command is not allowed if NetView is installed with the DASD Conserva- 
tion Option. You should issue this command from a host that was not 
installed with the DASD Conservation Option. 

To get additional online help for the 4700 support facility (mvs and VSE only), enter: 

HELP TARA | 

To get online help from within the 4700 support facility, enter either: 

HELP 

or 


NCCF HELP TARA 


Chapter 4. Getting Acquainted with the Hardware Monitor 4-13 


4-14 NetView Operation 


The purpose of this chapter is to show you some of the things you can do with the 
hardware monitor (NPDA). For specific command syntax or for more information, 
see “NPDA” on page 6-24. You can receive online help for the 4700 support 
facility by entering: 


HELP TARA COMMANDS 

You can also receive online help information on the hardware monitor (NPDA) com- 
mands by entering the following commands: 

HELP COMMANDS 


HELP NPDA COMMANDS 


Note: The HELP command is not allowed if NetView is installed with the DASD Con- 
servation Option. (See “Online Help Information” on page 4-12.) 


Getting to the Hardware Monitor 


lf the hardware monitor is not already started, use the STARTCNM CLIST to start the 
task. To get to the hardware monitor (NPDA), use the NPDA command or in the case 
of NetView installed with the DASD Conservation Option, issue NPDA followed by an 
available hardware monitor command. 


The hardware monitor provides additional support for the 3600/4700 Communi- 
cation Systems. In this publication, the term 4700 support facility will refer to this 
additional support. To get to the 4700 support facility (for MvS and VSE only), use 
the TARA command. 


Panel Commands 


Use the following panel control commands to move from page to page ina 
multiple-page display or to a different level within the hardware monitor hierarchy. 


e BACK (page 6-6) 


Displays a previous page of the same display level. If you are on the first 
page, that page is re-displayed. 


¢ FORWARD (page 6-19) 


Displays a following page in a multiple-page display. If you are on the last 
page, it will wrap to display the first page. 


e TOP (page 6-50) 

Displays the first page in a multiple-page display. 
e END (page 6-17) 

Stops the hardware monitor. 
e RESUME (page 6-33) 


Entered on a panel of another NetView component, takes you back to the hard- 
ware monitor panel you were viewing before you went to the other component. 
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e RETURN (page 6-34) 

Presents the last page viewed at the previous display level. 
e BOTTOM (page 6-7) 

Displays the last page in a multiple-page display. 
e COPY (page 6-9) 


Prints a copy of the panel you are viewing on your hard-copy log or in your 
network log. 


HELP Commands 


Use the following commands to view instructions on how to use the hardware 
monitor to view error or statistical data: 


¢ COMMAND (page 6-8) 

Lists all the commands that retrieve and control data in the data base. 
e HELP (page 6-20) 

Provides the following: 


— Terms for the last hardware monitor panel displayed 

— Explanation of the hardware monitor prompts 

— Listing of the hardware monitor display contro! commands 

— Information common to all displays 

— Complete set and format of the hardware monitor display commands 
— Overview 

— Help for CLists 

— Recommended Action descriptions. 


e MENU (page 6-21) 
Displays the hardware monitor menu panel. 
e ? (QUESTION MARK) (page 6-52) 


Gives the definition of a term or phrase used as a heading on a hardware 
monitor data display. 


Note: This command is not allowed if NetView is installed with the DASD Conserva- 
tion Option. 


Using Filters 


The informational and error messages sent by the network hardware can be con- 
trolled in part by using filters. Recording filters control what information is 
recorded into the hardware monitor's data base. Once the data has been 
recorded, another set of filters can be set for each network operator. These 
viewing filters determine which records will appear on an individual's terminal. 


You can use the PDFILTER CLIST to set both recording and viewing filters after your 

- system programmer has customized the PDFILTER CLIST. Viewing filters should not 
have been set by the system programmer for a NetView installed with the DASD 
Conservation Option. 
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Recording Filters 


Viewing Filters 


Recording filters can be set to pass or block information, and so control what infor- 
mation the hardware monitor stores on its data base for all users. Recording 
filters are also used to determine which events are to be treated as alerts. The 
setting of recording filters may be limited on your system to certain operators; 
check with your system operator if this is the case. 
Use the following commands to control your recording filters: 

¢ DFILTER (page 6-12) 

Displays the recording filters that are in use. 
e SRFILTER (page 6-38) 


Controls which records are recorded. 


Viewing filters control what information is either passed or blocked to individual 
users. You may use the viewing filter to limit those alerts that you see, based on 
type of event, or specific resource. You can also specify that only those events that 
occurred within a specified time be displayed. This allows you to concentrate on 
the most recent problems. You do not need special authorization to change your 
viewing filters. 
Use the following commands to control your viewing filters. 

¢ DFILTER (page 6-12) 

Displays the viewing filters that are in effect. 
e SVFILTER (page 6-43) 


Controls which records you will see at your terminal. 


Using Statistical Information 


Use the following commands to display or manage statistical information. 
e MRECENT (page 6-22) or STATS (page 6-42) 


Displays a date and time listing of the most recent statistics for a specified 
resource. 


e PURGE (page 6-27) or PRGATT (page 6-26) 
Removes statistical data for resources specified. 
e¢ PURGEDB (page 6-29) 
Purges hardware monitor and session monitor data. 
¢ TOTAL (page 6-51) 
Displays all statistical counts for specific resources. 
e¢ REQMS (page 6-32) 


Requests SNA Summary error counters. 
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Using Event Information 
Use the following commands to display or manage event information. 
¢ MRECENT (page 6-22) or EVENTS (page 6-18) 


Displays a date and time listing of the most recent events for a specified 
resource. 


¢ PURGE (page 6-27) or PRGATT (page 6-26) 
Removes event data for resources specified. 
¢ PURGEDB (page 6-29) 
Purges hardware monitor and session monitor data. 
¢ TOTAL (page 6-51) 


Displays all event records for a specified resource. 


Using Alert Information 


Alerts are stored in the hardware monitor data base and are displayed in reverse- 
chronological order. There are several different ways to control the generation of 
alerts: 


¢ SRATIO (page 6-36) 


Sets the error-to-traffic ratio threshold. When this threshold is exceeded, an 
event is created. If the event qualifies as an alert, an alert recording is also 
created. 


¢ SRFILTER (page 6-38) 


Specifies conditions under which data is to be recorded into the data base. 


To view alerts, use the following commands: 
¢ ALERTSD (page 6-4) 
Displays recent alerts. 
¢ ALERTSH (page 6-5) 


Displays history of alerts. 


Using Control Unit Information 


The CTRL command (page 6-10) displays data solicited from a specified control 
unit and solicits data if it can. 


Obtaining Specific Resource Information 


Use the following commands to obtain specific resource information. 
¢ DDOMAIN (page 6-11) 


Displays the identification of the domain that you are in or the domain in which 
a specified resource is active. | 
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¢ DWRAP (page 6-16) 


Displays the maximum number of records that will be kept for a specified 
resource. 


Using Modem Information 


The TEST command (page 6-48) conducts a test of the modems and communi- 


cations lines through which a specific resource is attached. It also displays the 
results. 


Using Error-to-Traffic Information 


The DRATIO command (page 6-15) displays current ratio in effect for the error-to- 
traffic threshold for a specific resource. 


Using Cross-Domain Commands 
Use the following commands to get information from another domain: 
¢ SDOMAIN (page 6-35) 
Changes the domain from which data will be retrieved. 
e DDOMAIN (page 6-11) 


Displays the identification of the domain that you are in or the domain in which 
a specified resource is active. 


Logging Information to SMF or an External Log 


You can use the REPORTS command (page 6-31) to control the logging of hardware 
monitor data to SMF (MVS and VSE only) or an external log. 


uvs vse Using 4700 Support Facility Commands 


The hardware monitor provides support for the 3600/4700 Finance Communications 
Systems. To access this support (called the 4700 support facility), use the TARA 
command (page 6-72). There are several commands that you can use once you 


have requested this additional support. These commands can be categorized as 
follows: 


e Panel commands 
e Help commands 
¢ Controller commands. 


Using Panel Commands 


Use the following commands to move from page to page in a multipage display or 
to a different level within the 4700 support facility hierarchy. 


e BACK (page 6-55) 
Displays a previous page of the same display level. 


e END (page 6-61) 
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Stops the 4700 support facility. 
e FORWARD (page 6-62) 

Displays the next sequential page of a multipage panel. 
e RESUME (page 6-66) 


Entered on a panel of another NetView component, takes you back to the 4700 
support facility panel you were viewing before you went to the other compo- 
nent. 


e RETURN (page 6-67) 

Displays a previous page of another display level. 
e TOP (page 6-75) 

Displays the first page in a multiple page display. 


Using Help Commands 


Use the following commands to display the menu and give assistance with com- 
mands. 


e ACTION (page 6-3) 
Provides a description of a specified recommended action. 
¢ COMMAND (page 6-56) 
Displays commands not explained by help commands. 
e HELP (page 6-63) 
Gives explanation of display control commands. 
e MENU (page 6-65) 
Displays the 4700 support facility menu. 


Using Controller Commands 
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Use the following commands and CLIsTs for information on controllers being used 
with the 4700 support facility. 


e ALLC (page 6-54) 
Displays a summary of the 3600 or 4700 controllers. 
e CTRL (page 6-58) or TCTRL (page 6-73) 


Display summary of the data and status of a specified controller and its 
resources. 


e DISPLAY (page 6-59), TTERR (page 6-77), TTRESP (page 6-78), TWERR (page 
6-79), TWRESP (page 6-81), or TWSTAT (page 6-82) 


Display the 4700 support facility operational operands associated with a speci- 


fied controller. 
e LOOP (page 6-64), TERR (page 6-74), or TSTAT (page 6-76) 

Display Loop Most Recent Status and Loop Most Recent Error displays. 
¢ SET (page 6-68) 


Allows you to adjust the operational operands of the 4700 support facility. 


e WKSTA (page 6-83) or TWKSTA (page 6-80) 

Provide the Workstation Most Recent Response Time display. 
e SYSMON (page 6-71) 

Provides access to the System Monitor in a 3600 or 4700 controller. 
¢ SOLICIT (page 6-70) 


Requests data and status from a 3600 or 4700 controller. 
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Chapter 6. Hardware Monitor Command Descriptions 


This section describes the formats and operands of the hardware monitor (NPDA) 
commands and CLISTs followed by a list of the 4700 Support Facility commands and 
CLiISTs. The hardware monitor commands can be entered from any component. 


The commands are listed in alphabetical order for easy reference. Each command 
description includes the format and description of operands and, where applicable, 
usage notes, responses, and examples. 


The syntax and notation conventions used for the commands and CLISTs are as 
follows: 


Items shown in braces { } represent alternatives. You must choose one. For 
example, 


A 
B or {A|BjC} 
C 


indicates that you must specify one item only: A, B, or C. 


Items shown in brackets [ ] are optional. You may choose one or none. For 
example, 


A 
B or [A|B/C] 
C 


indicates that you may enter A, B, or C, or you may omit the operand. 


A series of three periods (...) indicates that a variable number of items may be 
included in the list. 


An underscored item shows the alternative the system will choose if you do not 
specify an item. For example, 


A 
B 


LC 


If no operand is specified, B is assumed. 


Lowercase italicized items are variable; substitute your own value for them. 
Uppercase items must be entered exactly as shown. 


Parentheses must be entered as shown. 


Where keywords can be abbreviated, the abbreviations are shown in capital 
letters. For example, 


All 


can be entered as A or ALL. 
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e Where brackets ([ ]) are nested, you must include commas to denote the 
absence of the required positional operands. For example, 


Act A 
[.B 
[,C]] 


To specify c only, enter ACT A,,C. 


For online help on the hardware monitor commands, enter one of the following: 


HELP NPDA COMMANDS 
HELP TARA COMMANDS 


For help on a specific command, enter the following: 
NPDA HELP command 


where command is the name of the command. 


In the format of the commands, wherever N precedes resname, you can have up to 
five resource names to fully qualify the resource you are requesting information 
on. Wherever T precedes type, you can have up to five resource types. 


This command is not allowed if NetView is installed with the DASD Conservation 
Option. 


There will be a statement in the usage note section for each command that is not 
allowed or conditionally allowed when NetView has been installed with the DASD 
Conservation Option. 


ACTION 


The ACTION CLIST provides a description of a specified recommended action. 


The format of the ACTION CLIST is: 


ACTION nnn 

where: 

Dnnn specifies the number of the recommended action. 
Usage Note 


Use this CLIST to get additional information on a recommended action. Actions 
shown on Recommended Action panels are those you can take to bypass or 
resolve the event and are presented in the order most likely to be successful. 


The only recommended actions that will work when the NetView program is 
installed are the Dnnn descriptions. Ennn and innn numbers will be used for the 
generic alert code points. The innn numbers will be used for the !BmM-defined code 
points and the Ennn numbers will be used for the user-defined code points. For 
further information, refer to NetView Customization. 


This command is not allowed if NetView is installed with the DASD Conservation 
Option. (See “Using the Hardware Monitor” on page 4-4.) 


Example 


To see a description of recommended action D023, enter: 
ACTION DOQ23 
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ALERTSD 


The ALERTSD command presents you with the Alerts-Dynamic display. 


The format of the ALERTSD command is: 


Usage Note 


The abbreviation for this command is ALD. 


The Alerts-Dynamic display shows alerts as they are received. As each new alert 
arrives, it appears at the top of the display pushing the oldest alert off the bottom of 
the display. 


This command is not allowed if NetView is installed with the DASD Conservation 
Option. (See “Using the Hardware Monitor” on page 4-4.) 


6-4 NetView Operation 


ALERTSH 


The ALERTSH command presents you with the Alerts-History display. 


The format of the ALERTSH Command is: 


ALertSH 


Usage Note 
The abbreviation for this command is ALH. 


The Alerts-History display shows all alerts from the hardware monitor data base. 
An operator can log records to Information/Management from this display. This 
can be a multiple-page display. Information/Management will not support the 
printing of Kanji characters. Unexpected results may occur. The number of alerts 
shown on the Alerts-History display is determined by the alerts wrap count. See 
“DWRAP” on page 6-16 and “SWRAP” on page 6-46 for syntax. 


This command is not allowed if NetView is installed with the DASD Conservation 
Option. (See “Using the Hardware Monitor” on page 4-4.) 
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BACK 


The BACK command displays the previous page of a multipage display. 


The format of the BACK command is: 


where: 


n specifies the number of pages to back up. Range of nis 0 to 999. The default 
is 1. 


Usage Note 

The abbreviation for this command is B. 

You cannot go backward past the first page. PF7 is set to the BACK command if you 
use the PFKDEF CLIST. (Ask your lead operator whether your default PF key settings 


are established.) 


This command is not allowed if NetView is installed with the DASD Conservation 
Option. (See “Using the Hardware Monitor” on page 4-4.) 


Example 


To look at a page that is three pages back, type: 
B 3 
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BOTTOM 


The BOTTOM command displays the last page of a multipage display. 


The format of the BOTTOM command is: 


BOTtom 


Usage Note 
The abbreviation for this command is BOT. 


PF5 is set to the BOTTOM command if the PFKDEF CLIST is invoked. (Ask your lead 
operator whether your default PF key settings are established.) 


This command is not allowed if NetView is installed with the DASD Conservation 
Option. (See “Using the Hardware Monitor” on page 4-4.) 


Example 


To get to the last page of a multiple-page display, enter: 
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COMMAND 


The COMMAND command displays a menu of all commands that you can use in the 
hardware monitor. A command description display can then be selected for any 
specific command. 


The format of the COMMAND command is: 
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Usage Note 


This command is not allowed if NetView is installed with the DASD Conservation 
Option. (See “Using the Hardware Monitor” on page 4-4.) 


COPY 


The CoPpY command sends a copy of the current display to the network log or toa 
hard-copy terminal if one is connected. 


The format of the COPY command is: 


COPY 


Usage Note 


Messages displayed at the operator's terminal indicate the success or failure of the 
COPY operation. 


This command is not allowed if NetView is installed with the DASD Conservation 
Option. (See “Using the Hardware Monitor” on page 4-4.) 


Example 


To make a copy of the current screen, enter: 


A copy of the screen will be recorded on the network log or printed on the hard- 
copy log if one is connected. 
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CTRL 


The CTRL command solicits and displays controller link test data, hardware or 
microcode levels, or error data from a specific resource. 


The format of the CTRL command is: 


where: 

resname specifies the symbolic name of the resource. You can specify up to 
five resource names to fully qualify the resource for which data is to 
be displayed. 

LINK displays controller link test results and resets link test counters. 

LVL displays release levels of hardware and microcode in hexadecimal. 

SEC displays the most recent errors for the specified control unit. 


Usage Note 


This command solicits link test counts, summary error counters, and release level 
information from SNA controllers. If you enter an incomplete CTRL command, the 
hardware monitor prompts you for missing operands. If LINK, LVL, SEC, or the 
resource name is omitted, the hardware monitor prompts you for it. For resource 
names, anything other than a hardware monitor explicit command or the command 
facility command will be taken as a resource name. 


For the CTRL command with the option LVL, the hexadecimal part is the contents of a 
RECFMS05. A description of a RECFMS05 is in Appendix B of the NetView Diagnosis 


manual. 


This command is not allowed if NetView is installed with the DASD Conservation 
Option. (See “Using the Hardware Monitor” on page 4-4.) 


Example 


To view the release level for SNA Controller P51E40, enter: 


CTRL P5lE4O LYL 
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DDOMAIN 


The DDOMAIN command displays the identification of the domain in session or the 
current domain in which the specified resource resides. 


The format of the DDOMAIN command is: 


DDomain  [resname] 


where: 


resname specifies the symbolic name of the resource. You can specify up to 
five resource names to fully qualify the resource for which data is to 
be displayed. 


Usage Note 


If no name is specified, the hardware monitor presents the name of the domain in 
which you are currently operating as a result of the SET DOMAIN command (CURRENT 
DOMAIN) and the name of the domain that you are actually logged on to (HOST 
DOMAIN). 


To use DDOMAIN resname, an RRD statement for the resource must be included in 
DSIDMN. See the NetView Administration Reference for further information on the 


RRD statement. 


This command is not allowed if NetView is installed with the DASD Conservation 
Option. (see “Using the Hardware Monitor” on page 4-4.) 


Example 


To display the current domain identification, enter: 


Response 


if you specified a resource name, the response is: 


fee eh Sy Ce en i a, a [Fe eR ae A a an 

hay ah gh eee, RS Pe OE Sie dS Mey tte f We “we yh ge 
u Hoo Ly ie este Nope Sie ed rth ae A Mw | ye 
rhea rare 8 1 ere era Big wee BOW de meaty 


If you did not specify a resource name, the response is: 


ysiagh gae 1 1 . 5 es by * + f yA Pe ” yf a a * Hohe aah ts 4 : a 
Se a HP yoN Ae oes 4 i tom bp fa ies a Loud 4 is tahoe ‘ 
de aed et “ f,<2 Ry hao Boas LUN Be « Peed ft NPR ae a age ' 
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DFILTER 


The DFILTER command displays the recording or viewing filters that are currently in 
effect. 


The format of the DFILTER command is: 


where: 

AREC specifies the alert recording filters in use. 

ESREC specifies the event or statistics recording filters in use. 

OPER specifies the authorized operator filters in use. 

VIEW specifies the viewing filters in use. 

C code lists the description of the alert specified code. These codes are used 
in defining hardware monitor use filters. . 

Usage Note 


This command may not be executed from a hardware monitor alerts display. 


This command is not allowed if NetView is installed with the DASD Conservation 
Option. (See “Using the Hardware Monitor” on page 4-4.) 


Example 


To display the viewing filters that are currently in effect for your operator identifica- 
tion, enter: 


DFILTER VIEW 
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DIS 


The Dis CLIST displays the results of modem or controller tests. 


The format of the DIS CLIST is: 


DIS {resname1} 
{,LVL|,SEC|,LINK],EV|,ST} 


{resname2} 
{,resname3} 
{,DTE|,RST|,LS} 


{resname2} 
{,resname3} 
[,LSL1|,LSL2] 
{,LA|MLS|,TRT MN} 


where: 
resnamel specifies the cluster controller. 
resname2 specifies the communications or network controller. 


resname3 __ specifies the device at remote end of line. 


LVL displays levels of hardware and microcode. 

SEC displays the most recent events for name1. 

LINK displays link test results and resets link test counters. 

EV displays the most recent events for the specified resource. 
ST displays the most recent statistics for the specified resource. 
DTE displays the current and transition states of the EIA leads. 
RST conducts a remote self test. 

LS conducts and displays the results of a link status test. 

LSL1 conducts a test on link segment level one. LSL1 is the default. 
LSL2 conducts a test on link segment level two. 

LA conducts a line analysis test. 

MLS conducts a modem and line status test. 

TRT conducts a transmit/receive test. 

n the number of text sequences the modems should exchange. Valid 


only with the TRT operand. 
(See also “DIS” on page 3-56.) 
Usage Note 


The operands DTE, LS, and RST work with the 386x modems or the 586x modems with 
the line specified as LPDA—1. 
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The operands LSL1, LSL2, MLS, LA, and TRT work with the 586x modems only with the 
line specified as LPDA-2. | 
This CLIST generates the following hardware monitor commands: 


CTRL (page 6-10) 
MRECENT (page 6-22) 
TEST (page 6-48). 


This command is not allowed if NetView is installed with the DASD Conservation 
Option. (See “Using the Hardware Monitor” on page 4-4.) 
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DRATIO 


The DRATIO command displays the current ratio established for the error-to-traffic 
alerting threshold for a specified resource. 


The format of the DRATIO command is: 


DRatio N resname 
where: 
N specifies that the next operand is a resource name. 


resname specifies the symbolic name of the resource. You can specify up to 
five resource names to fully qualify the resource for which data is to 
be displayed. 

Usage Note 


The resource names which can be used with this command must have resource 
types of CTRL, DEV, LDEV, or LCTL. 


Whenever statistics are reported to the hardware monitor, the error counters and 
traffic counters are compared to determine the current error-to-traffic ratio. If this 
ratio exceeds the threshoid set by your system programmer, the statistic will 
become an alert unless blocked by an alert recording filter. 

If the name of the resource is not associated with a unique resource configuration 
on the data base, then a selection panel will be displayed on which the user can 
choose which configuration is relevant. 


This command may not be executed from a multiple entries display. 


This command is not allowed if NetView is installed with the DASD Conservation 
Option. (See “Using the Hardware Monitor” on page 4-4.) 


Example 


To display the status and threshold value of the error-to-traffic ratio for PUo8, enter: 
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DWRAP 


The DWRAP command displays the current wrap count. The wrap count is the 
number of records to be retained in the data base for a specified resource. 


The format of the DWRAP command is: 


Dwrap  |[eEV Nresname]| 


st Nresname} 
AL . 
where: 
EV displays the wrap count for event data. 
ST displays the wrap count for statistical data. 
AL displays the wrap count for alert data. 
N identifies the following operand as a resource name. 


resname specifies the symbolic name of the resource (for event and statistical 
data only). You can specify up to five resource names to fully qualify 
the resource for which data is to be displayed. 

Usage Note 

If the name of the resource is not associated with a unique resource configuration 

on the data base, then a selection panel will be displayed on which the user can 


choose which configuration is relevant. 


This command is not allowed if NetView is installed with the DASD Conservation 
Option. (See “Using the Hardware Monitor” on page 4-4.) 


Example 


To display the statistical data wrap count for Puos, enter: 
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END 


The END command stops the hardware monitor panel sequence and returns to the 
component from which the hardware monitor was invoked. 


The format of the END command is: 
End 


Usage Note 
The abbreviation for this command is E. 
Example 


To return to the component from which you entered the hardware monitor, enter: 
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EVENTS 


The EVENTS CLIST displays a reverse chronological list of the most recent events 
from a specified resource. 


The format of the EVENTS CLIST is: 


where: 

resname specifies the symbolic name of the resource. 

Usage Note 

This CLIST generates a MRECENT command. 

If the name of the resource is not associated with a unique resource configuration 
on the data base, then a selection panel will be displayed on which the user can 
choose which configuration is relevant. See “MRECENT” on page 6-22 for more 


information. 


This command is not allowed if NetView is installed with the DASD Conservation 
Option. (See “Using the Hardware Monitor” on page 4-4.) 


Example 


To view the most recent events for controller RALO1, enter: 
EVENTS RALOL 
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FORWARD 


The FORWARD command displays the next sequential page of a multiple-page panel. 


The format of the FORWARD command is: 


Forward = [n] 


where: 


n specifies the number of pages to move forward. Range of nis 0 to 999. The 
default is 1. 


Usage Note 


If you enter F or F 1 on the last page of a multiple page display, you will go to page 
1 of the display. 


If you enter F nnn where nnn is greater than the remaining number of pages, you 
will go to the last page of the display. 


If you enter F nnn from the last page, you will go to the first page of the display. 
This command can be abbreviated as F or FORW. PF8 is set to the FORWARD 
command if the PFKDEF CLIST is invoked. (Ask your lead operator whether your 


default PF key settings are established.) 


This command is not allowed if NetView is installed with the DASD Conservation 
Option. (See “Using the Hardware Monitor” on page 4-4.) 


Example 


To move ahead five pages, enter: 
FORWARD 5 


If there are five more pages in the current display, you see the fifth page forward 
from the current page. 
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HELP 


The HELP CLIST provides you with directions for moving from panel to panel ina 
multiple-page panel, or for moving through the hierarchy of the hardware monitor 
panels. It provides information on how to use the hardware monitor commands. 
HELP also provides access to the NetView online help facility, and to the hardware 
monitor glossary for the current display. 


The format of the HELP CLIST is: 


where: 


cmdname _ specifies the command name. 

Usage Note 

When you enter HELP from a help screen or a command description screen, 
NetView will present the Screen Control/Help Display. When you enter HELP from 
any other screens, NetView will present a help menu for the current display. To 
get help for a specific command, enter HELP cmd, where cmd is the command about 


which you need more information. 


This command is not allowed if NetView is installed with the DASD Conservation 
Option. (See “Using the Hardware Monitor” on page 4-4.) 


Example 


To display the syntax for the DFILTER command, enter: 
HELP DF 
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MENU 


The MENU command displays the hardware monitor main menu panel. 


The format of the MENU command is: 
Menu 
Usage Note 


This command is not allowed if NetView is installed with the DASD Conservation 
Option. (See “Using the Hardware Monitor” on page 4-4.) 
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MRECENT 


The MRECENT command displays in reverse chronological order a list of the most 
recent events or statistics for the specified resource. 


The format of the MRECENT command is: 


where: 

EV specifies the data type as event. 

ST specifies the data type as statistical. 

N identifies the operand that follows as a resource name. 


resname specifies the symbolic name of the resource. You can specify up to 
five resource names to fully qualify the resource for which data is to 
be displayed. 


A identifies that the operand that follows is an adapter address. 
adaptadr specifies the 12 hexadecimal digit adapter address. 

Usage Note 

The list of most recent events includes SNA controller event types, intensive mode 
recording (IMR), and permanently affected (PAFF) records. This command only dis- 
plays information from the data base. 

If the name of the resource is not associated with a unique resource configuration 
on the data base, then a selection panel will be displayed on which the user can 


choose which configuration is relevant. 


This command is not allowed if NetView is installed with the DASD Conservation 
Option. (See “Using the Hardware Monitor” on page 4-4.) 


Example 


To view the most recent statistics for controller RALO1, enter: 
MR ST N RALO1 
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NCCF 


The NCCF command is used to enter the command facility (NCCF). 


The format of the NCCF command is: 


NCCF [command [operands]] 


where: 


command is acommand facility command. If a command is not specified, the 
command facility is invoked. Command facility immediate commands 
are not accepted. 


operands are one or more operands that are passed to the command facility 
along with command. 


Usage Note 


If you enter NCCF without any operands, you see the command facility screen. Then 
you can enter a command facility command. If you enter a command, you must 
view the resulting messages and then return to the original screen (see “RETURN” 
on page 6-34) before entering more commands. 


When a command is sent to the command facility from another component, the 
command is processed by the command facility as if it had been entered directly 
from the command facility. 


When you use this command from another component, the command facility 


remains on the NetView component stack that is used with ROLL until the compo- 
nent is ended. 
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NPDA 


The NPDA command enters the hardware monitor, or is used to process a single 
hardware monitor command from another NetView component. 


The format of the command is: 


Usage Note 


Generally when you use this command, the hardware monitor will remain on the 
NetView component stack that is used with ROLL until the component is ended. The 
exceptions are when one of the following commands is issued: REPORTS, SRFILTER, 
SVFILTER, SWRAP, SRATIO, Or END. These commands can be executed from other 
NetView components without changing the state of the NetView component stack. 


If NetView is installed with the DASD Conservavion Option, the NPDA command 
cannot be issued without one of the following commands as a parameter: END, 
SRFILTER, REQMS, REPORTS, PURGE, PRGATT, and PURGEDB. In addition, if NPDA is issued 
as a prefix to either the PURGE, PRGATT, Or PURGEDB Command, it must be issued 
under the PPT. 
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PDFILTER 


The PDFILTER CLIST defines the viewing and recording filters that you will be using 
during your hardware monitor session. 


The format of the PDFILTER CLIST is: 
-PDFILTER _ 


Usage Note 


Before using this CLIST, check with your system programmer. Your system pro- 
grammer must update this CLIST before you can use it. 


For the DASD Conservation Option, the PDFILTER command is allowed, but it must 
contain SRFILTER Commands only. 
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PRGATT 


The PRGATT command removes event or statistical data for the specified resource 
and all the resources that are attached to it and known to the hardware monitor. 


The format of the PRGATT command is: 


where: 

EV specifies event data. 

ST specifies statistical data. 

. specifies both event and statistical data. 

—days deletes data that is older than the specified number of days (0-365). 
mmddyy deletes all data recorded before this month-day-year. 

i deletes data regardless of age. 

N specifies that the operand that follows is a resource name. 


resname specifies the symbolic name of the resource. You can specify up to 
five resource names to fully qualify the resource for which data is to 
be displayed. 


Usage Note 


This command can be useful if you rename your NcP. When generating a new NCP, 
a new set of hardware monitor data base records is recorded for each resource 
attached to the ncp. With this command all data base records for the specified 
resource and all attached resources will be purged. Multiple PRGATT or PURGE com- 
mands cannot be executed concurrently. 


If the name of the resource is not associated with a unique resource configuration 
on the data base, then a selection panel will be displayed on which the user can 
choose which configuration is relevant. 


Scope checking is done on the PRGATT command. You must be authorized to issue 
this command; check with your system programmer. 


This command is allowed when NetView is installed with the DASD Conservation 
Option only if it is invoked locally by a timer initiated command under the PPT. 


Example 


To erase all statistical data for NCP001 and all resources attached to it, enter: 
PRGATT ST * N NCPOO] 
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PURGE 


The PURGE command removes event or statistical data for a specified resource or 
for all resources from the data base. In addition, it can purge all information based 
on the adapter address. 


The format of the PURGE command is: 


PURGe fev) days | 7 _ 
- | | = | Oe mmddyy 7 — ON - | { resheme 
See A eS nee ea rd Mace 2 Vac de 
{ev} ee eae A { adaptadr} 
where: 
EV specifies event data. 
ST specifies statistical data. 


specifies both event and statistical data. 

— days deletes data that is older than the specified number of days (0-365). 
mmddyy deletes all the data before this month-day-year. 

deletes data regardless of age. 

N identifies that the operand that follows is a resource name. 


resname specifies the symbolic name of the resource. You can specify up to 
five resource names to fully qualify the resource for which data is to 


be displayed. 
*ALL deletes data for the date previously noted for all resources. 
A identifies that the operand that follows is an adapter address. 


adaptadr specifies the 12 hexadecimal digit adapter address. 

Usage Note 

The abbreviation for this command is PRG. 

This command does not purge records for attached resources. 

The recording function is suspended when a purge of the entire data base is in 
progress and incoming data may be lost. Multiple PURGE or PRGATT commands 
Cannot be executed concurrently. 

If the name of the resource is not associated with a unique resource configuration 
on the data base, then a selection panel will be displayed on which the user can 


choose which configuration is relevant. 


Scope checking is done on the PURGE command. You must be authorized to issue 
this command; check with your system programmer. 


This command is allowed when NetView is installed with the DASD Conservation 
Option only if it is invoked locally by a timer initiated command under the PPT. 
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Example 

To erase all records on an event data base that were recorded before March 1, 
1985, enter: | 

PURGE EV 030185 N *ALL 
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PURGEDB 


The PURGEDB command purges hardware monitor and session monitor data. 


The format of the PURGEDB command is: 


PURGEDB {[ROUTE|RT] | BEFORE date [time] | 
| [SESSION|SESS] resname? resname2- | BEFORE date [time] | 

RT/SESS © BEFORE date [time] 
[EVENT|IEV] —— [ATTACHED|ATT] {resname|*ALL|addr} BEFORE date 
[STAT|ST] _ [ATTACHED|ATT]}{resname|*ALL} © BEFORE date 
EV/ST [ATTACHED|ATT] {resname|*ALL} BEFORE date 

where: 

ROUTE|RT specifies session monitor ROUTE data. 


SESSION|SESS _ specifies session monitor SESSION data. 


RT/SESS specifies session monitor ROUTE and SESSION data. 

EVENTIEV specifies hardware monitor EVENT data. 

STAT|ST specifies hardware monitor STAT data. 

EV/ST specifies hardware monitor EVENT and STAT data. 

resname1|resname2 specifies the name of the resource for which purging is to be 
done. 

ATTACHED specifies if resource is attached. 

"ALL deletes data for all resources. 

addr specifies a 12 hexadecimal! digit address. 

date acceptable formats for date are: 


e MM/DD/YY - leading zeros are not required 
e MMDDYY - leading zeros are required 
e -NNN - number (from 0-365) 
e *- current date (and current time unless time also speci- 
fied). 
time acceptable formats for time are: 


e HH:MM:SS - Leading zeros are not required 
e HH:MM - leading zeros are not required 
e *- current time. 


Usage Note 


Scope checking is done on the PURGEDB command. You must be authorized to use 
this command; check with your system programmer. 


This command is allowed when NetView is installed with the DASD Conservation 
Option only if it is invoked locally by a timer initiated command under the PPT. 
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Example 


To purge hardware monitor data, enter: 
PURGEDB EV/ST *ALL BEFORE * 


All event and stat data before the current system date and time is purged. 
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REPORTS 


The REPORTS command controls the logging of report records. 


The format of the REPORTS command is: 
REPORTS — [ON|OFF] 


where: 

ON starts report logging. 

OFF stops report logging. 

Usage Note 

REPORTS Causes report records to be written to SMF (MVS only) or an external file. 
(See the NetView Hardware Problem Determination Reference for the format of this 


record.) 


Scope checking is done on the REPORTS command. You must be authorized to use 
this command; check with your system programmer. 


For NetView Release 2 Kanji, you need to have the Kanji release of SLR to run 
Service Level Recorder (SLR) against SMF logs. 
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REQMS 


The REQMS command requests SNA Summary error counts from a physical unit and 
stores the data on the hardware monitor data base. 


The format of the REQMS command is: 


where: 

puname specifies the physical unit name. 

Y specifies that you will be notified of positive and negative responses. 

N specifies that you will only be notified of a negative response to the 
request. This is the default. 

Usage Note 


You can also use the REQMS command in a CLIST. However, this command should 
not be used in a CLIST before you start the hardware monitor. 


Example 


To request error data and statistics from Pu04, enter: 
REQMS PUQ4 
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RESUME 


The RESUME command returns to the hardware monitor panel from which you 
issued a command that took you to another NetView component. 


The format of the RESUME command is: 
RESUME 


Usage Note 


The RESUME operation can also be done simply by entering the NPDA command 
while in another component. 


This command is not allowed if NetView is installed with the DASD Conservation 
Option. (See “Using the Hardware Monitor” on page 4-4.) 
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RETURN 


The RETURN Command presents the last panel that you viewed at the previous level 
in the panel hierarchy of the hardware monitor. 


The format of the RETURN command is: 


Usage Note 


The hardware monitor maintains a table (called the hierarchy table) to keep track 
of the sequence of displays you have viewed. When you issue an explicit hardware 
monitor command, this table is reset and the display sequence is lost. Therefore, 

if you enter RETURN from a display that is presented as the result of an explicit hard- 
ware monitor command, NetView takes you back to the hardware monitor main 
menu, not to the display you were viewing before you issued the explicit command. 
If you issued the RETURN Command from the Help panel, you are returned to the 
panel from which you requested help. 


PF3 is set to the RETURN command. 


This command is not allowed if NetView is installed with the DASD Conservation 
Option. (See “Using the Hardware Monitor” on page 4-4.) 
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SDOMAIN 


The SDOMAIN command allows you to view data stored in another domain. 


The format of the SDOMAIN Command is: 
sDomain domainid = [quiet] 


where: 


domainid specifies the symbolic name of the NetView domain where you want 
to view data (up to five characters) 


quiet sets domain and returns a message for automation (used from a 
CLIST) 


Usage Note 


Before using the SDOMAIN command, a session must exist between the hosts in the 
two domains. (See “START” on page 3-156 and “STARTDOM” on page 3-159.) 


This command may not be executed from a multiple entries display. 

If the DASD Conservation Option was installed, you must issue the SDOMAIN 
command to a host having DASD Conservation Option installed from a node having 
full NetView installed in order to view complete hardware monitor data and other 
commands that are not allowed when NetView has been installed with the DASD 
Conservation Option. 


This command is not allowed if NetView is installed with the DASD Conservation 
Option. (See “Using the Hardware Monitor” on page 4-4.) 


Example 


To view data in the NCCF2 domain, enter: 
SDOMAIN NCCF2 


Response 


The normal response will be: 
BNJ911I CURRENT DOMAIN NOW NCCF2, WAS NCCF1 
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SRATIO 


The SRATIO command allows you to: 


e Enable or disable the creation of a performance event for a specified resource 
when an £/T threshold is exceeded. 


e Change the threshold value that generates an alert for a specified resource. 


The format of the SRATIO command is: 


where: 

ON specifies that the forwarding of performance events about the resource 
is to be enabled. This status is implied if a threshold value is entered. 

OFF specifies that the forwarding of performance events about the resource 
is to be disabled. 

nnn specifies the new threshold value. The value can have a range of from 
000 to 250 that is interpreted as 00.0 to 25.0 percent. The leading zeros 
are required. 

N identifies that the operand that follows is a resource name. 


resname_ specifies the symbolic name of the resource. You can specify up to five 
resource names to fully qualify the resource for which data is to be dis- 
played. You can specify up to five resource names. 


Usage Note 


Scope checking is done on the SRATIO command. You must be authorized to issue 
this command. Check with your system programmer. 


A default operand of ON is set for each threshold resource when it initially records 
data in the data base. At the same time, if no threshold value for the resource was 
established during installation, the hardware monitor assigns default E/T ratios as 
follows: 


Link-attached communications device, 3.0% 


Channel-attached communications device, 1.0%. 
If the name of the resource is not associated with a unique resource configuration 
on the data base, then a selection panel will be displayed on which the user can 


choose which configuration is relevant. 


No performance events will be generated if the statistical record is the result of a 
permanent error or deactivation of a resource. 


This command may not be executed from a multiple entries display. 


This command is not allowed if NetView is installed with the DASD Conservation 
Option. (See “Using the Hardware Monitor” on page 4-4.) 
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Example 


To enable error-to-traffic event generation for Puos, enter: 


SR ON N PUOS 
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SRFILTER 


: The SRFILTER Command allows you to establish the conditions governing the 
recording of data in the hardware monitor data base and also controls the for- 
warding of alert data to the NetView operator. 


The format of the SRFILTER command is: 


where: 


AREC 


ESREC 


OPER 
CLEAR 
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P PRODLD Al ALERT-ID v 


Ri OK adaptadr 
| Nresname- 
ee _ NREF resname. 
es Sr type:” 
Lh: ued type 


sets a filter which controls whether alerts are to be sent to the network 
operator. 


sets a filter which controls whether events and statistics are to be sent 
to the network controller. 


sets filters for transmission of alert to an authorized operator. 


specifies that all filter elements are to be removed and that the default 
conditions for the filters are to be applied to all data. No other oper- 
ands, except the filter type, are to be specified when the CLEAR operand 
is used. Defaults are initially provided by the hardware monitor and 
become effective when specified filter elements fail to select a data 
record. These defaults are shown below. 


ESREC filter for event and statistical recording filters, PASS passes all 


records to the event data base. 


AREC filter for alert recording filters, the following conditions are 


tested in the following order until a condition is satisfied: 


BLOCK E HELD TREF CTRL 
blocks any HELD event type records received 
from any resource of type CTRL or from any 
resource attached to a resource of type CTRL. 


BLOCK E HELD TREF LCTL 
blocks any HELD event type records received 
from any resource of type LCTL or from any 
resource attached to a resource of type LCTL. 


PASS E PERM TREF CTRL 
passes any PERM event type records received 
from any resource of type CTRL or from any 
resource attached to a resource of type CTRL. 


PASS E PERM TREF LCTL 
passes any PERM event type records received 
from any resource of type LCTL or from any 
resource attached to a resource of type LCTL. 


PASS E PERF TREF CTRL 
passes any PERF event type records received 
from any resource of type CTRL or from any 
resource attached to a resource of type CTRL. 


PASS E PERF TREF LCTL 
passes any PERF event type records received 
from any resource of type LCTL or from any 
resource attached to a resource of type LCTL. 


BLOCK TREF CPU 
blocks any records received from any resource 
of type CPU or from any resource attached to a 
resource of type CPU. 


BLOCK E HELD 
blocks any HELD event type records. 


PASS E INST 
passes any INST event type records. 


PASS E NTFY 
passes any NTFY event type records. 


PASS E PERF 
passes any PERF event type records. 


PASS E PERM 
passes any PERM event type records. 


PASS E SCUR 
passes any SCUR event type records. 


PASS E UNKN 
passes any UNKN event type records. 


PASS E USER 
passes any USER event type records. 


BLOCK 
blocks all records not satisfying any of the con- 
ditions above. 


OPER filter for operator alert filters, BLOCK blocks all alert records 
from being transmitted to the authorized operator. 
BLOCK _ specifies that the data matching the conditions expressed in this filter 
element are to be blocked from the hardware monitor data base or from 
the network operator. 


PASS specifies that the data matching the conditions expressed in this filter 
element are to be allowed through to the hardware monitor data base or 
to the network operator. 
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code 


p 
PROD-ID 


identifies that the operand that follows is an event (alert) probable cause 
descriptor identifying code. 


specifies the code that identifies a particular event or alert description 
or probable cause descriptor. This code can be determined by entering 
the appropriate SEL number (NN) plus the character ‘c’ on the command 
line of the Alerts-History, Alerts-Static, or Most Recent Events displays 
and appears as CCCCC in the message. 


specifies the product identifier or alert identifier pair. 


specifies the variable product identifier (hardware or software) of the 
alert or event sender. 


ALERT-ID specifies the variable alert ID number representing a specific alert or 


event description. 


A specifies the adapter address. 

adaptadr specifies the variable adapter address (1 address of 21 hexadecimal 
digits). 

E identifies that the operand that follows is an event type. 

etype specifies the event type on which the filter item is based. Event types 
are AVAL, CUST, DLRC, ENV, HELD, IMPD, IMR, INST, INTV, NTFY, PAFF, PERF, PERM, 
PROC, SCUR, SNA, TEMP, UNKN, and USER. 

N identifies that the operand that follows is a resource name. 

resname_ specifies the symbolic name of the resource. You can specify up to five 
resource names to fully qualify the resource for which data is to be dis- 
played. 

NREF records received from the named resource or from any resource 
attached to it are affected. The use of asterisks in specifying resource 
names following the NREF keyword is not permitted. 

LE identifies that the operand that follows is a resource type. 

type specifies the resource type. Resource types include CPU, CHAN, LCTRL, 
and COMC. 

TREF records received from any resource of the specified type or from any 
resource attached to a resource of this type are affected. 

Usage Note 


A record must pass both the ESREC and AREC recording filters to be recorded as an 
alert. It must also pass the OPER filter to cause immediate Authorized Operator 
notification. Filter elements must be specified in the order shown in the box on 
6-38. Scope checking is done on the SRFILTER Command. You must be authorized 
to issue this command. See your lead operator or system programmer. 


The following conditions are tested in the order given to determine whether a data 
record matches the filter: 


1. An event (alert) probable cause descriptor code (keyword P or c) anda 
resource name (keyword N) 


2. An event (alert) description or probable cause code (keyword P or c) 


3. An event type (keyword E) and a resource name (keyword N) 
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4. Aresource name (keyword N) 


5. An event type (keyword E) and a higher level resource name reference 
(keyword NREF) 


. A higher level resource name reference (keyword NREF) 
. An event type (keyword E) and a resource type (keyword T) 


. A resource type (keyword T) 


oO aoa nN QD 


. An event type (keyword E) and a higher level resource type reference (keyword 
TREF) 


10. A higher level resource type reference (keyword TREF) 


11. An event type (keyword E). 


If any of these matches occurs, the matching filter element action (PASS or BLOCK) is 
processed and further testing is suspended. 


If the record fails to match any of the above conditions, the default for the record 
type is processed. 


Example 


To block information for PU3 with an event and statistical filter, enter: 
SRFILTER ESREC BLOCK N PU3 


Response 


The normal response to this command is: 
BNJ13411 SRF/SRFILTER COMMAND ACCEPTED 
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| The STATS CLIST displays a list of the most recent statistics for the specified 
resource. 


The format of the STATS CLIST is: 


where: 


resname specifies the symbolic name of the resource. 
Usage Note 
The CLIsTt generates the NPDA MR ST command. See page 6-22 for more information. 


This command is not allowed if NetView is installed with the DASD Conservation 
Option. (See “Using the Hardware Monitor” on page 4-4.) 


Example 


To generate the Most Recent display for Puos, enter: 
STATS PUOQ8 
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SVFILTER 


The SVFILTER command allows you to control which records will be displayed at 
your terminal. 


The format of the SVFILTER command is: 


SvFilter 


where: 


CLEAR 


N 


resname 


NREF 


TIME 


CLEAR 
N resname 
E etype NREF resname 
Ttype — 
BLOCK TREF type 
PASS 
N resname 
NREF resname 
T type 
. TREF type 
PASS TIME hh:mm|mm 


specifies that all the current filter elements are to be removed and 
that the default condition for viewing filters (PASS) is to be applied to 
all data. No other operands are to be specified when the CLEAR 
operand is used. 


specifies that the data matching the conditions expressed in this filter 
element are to be blocked from view. 


specifies that the data matching the conditions expressed in this filter 
element are to be allowed through for viewing. 


identifies that the operand that follows is an event type. 


specifies the event type on which the filter item is based. Event types 
are AVAL, CUST, DLRC, ENV, HELD, IMPD, IMR, INST, INTV, NTFY, PAFF, PERF, PERM, 
PROC, SCUR, SNA, TEMP, UNKN, and USER. When this is the only SVFILTER 
specification, it is effective only while you are viewing the Most 
Recent Events or the alert displays. 


identifies that the operand that follows is a resource name. 


specifies the symbolic name of the resource. You can specify up to 
five resource names to fully qualify the resource for which data is to 
be displayed. 


records received from the named resource or from any resource 
attached to it are affected. The use of asterisks in specifying 
resource names following the NREF keyword is not permitted. 


identifies operand that follows as a resource type. 


specifies that only resources for which data was recorded during the 
indicated time period before the data request are to be displayed. 
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hh:mm specifies the elapsed time in hours and minutes to be used with the 
TIME operand. The maximum values allowed are 99 for hh and 59 for 


mm. 

mm specifies the elapsed time in minutes to be used with the TIME 
operand. The maximum value allowed is 99 for mm. 

TREF records received from any resource of the specified type or from any 
resource attached to a resource of this type are affected. 

type specifies the resource type. Resource types include CPU, CHAN, LCTRL, 
and COMC. 

Usage Note 


Filter elements must be specified in the order shown above. Each operator must 
specify his own viewing filters. 


You can use the SVFILTER command in a CLIST. 


With the exception of time, all viewing filters apply only to the Alerts-Display 
except as noted in etype. 


If the name of the resource is not associated with a unique resource configuration 
on the data base, then a selection panel will be displayed on which the user can 


choose which configuration is relevant. 


This command is not allowed if NetView is installed with the DASD Conservation 
Option. (See “Using the Hardware Monitor” on page 4-4.) 


Example 


To set a filter so only total events less than 3 hours old are viewed, enter: 
SVF PASS TIME 3:00 


Response 


The normal response to this command is: 
BNJ13551 SVF/SVFILTER COMMAND ACCEPTED 
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SWPD 


The SWPD CLIST switches the primary and secondary data bases associated with 
hardware monitor’s BNJDSERV task. The files are used to record hardware monitor 
data. 


The format of the SWPD CLIST is: 
swep ss {pis} 


where: 
P specifies primary data base. 


S specifies secondary data base. 

Usage Note 

Use this CLIST to make the primary or secondary data base active. 
This command may not be executed from a multiple entries display. 


This command is not allowed if NetView is installed with the DASD Conservation 
Option. (See “Using the Hardware Monitor” on page 4-4.) 


Example 


To switch to the primary data base, enter: 
SWF) P 
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SWRAP 


The SWRAP command establishes the number of event or statistical records to be 
retained for a specified resource or the total number of alert records to be retained 
on the hardware monitor data base. 


The format of the SwRAP command is: 


where: 

EV specifies event data. 

ST specifies statistical data. 

AL specifies alert data. 

nnn specifies the wrap count value, 0-999. 

N specifies that the operand that follows is a resource name. 


resname_ specifies the symbolic name of the resource (for event and statistical 
data only). You can specify up to five resource names to fully qualify the 
resource for which data is to be displayed. 


Usage Note 


Scope checking is done on the SwRAP command. You must be authorized to issue 
this command. See your system programmer. 


If the name of the resource is not associated with a unique resource configuration 
on the data base, then a selection panel will be displayed on which the user can 
choose which configuration is relevant. 


A SWRAP command can only be issued for resources against which data has been 
logged on the hardware monitor data base. 


When a reduction in the wrap count value is requested by this command, the oldest 
records are deleted immediately. If the wrap count is very low, it may appear that 
the oldest record is not being wrapped off, because the new record will fit on the 
screen without deleting the old record from the screen. Actually, the oldest record 
is wrapped off the permanent data base and Is maintained on a temporary data 
base until you return to the hardware monitor menu or enter an explicit hardware 
monitor command. The default wrap counts are: 
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Event records per resource 
- per resource 
- per resource of type LAN or type RING 


Statistical records per resource 
- per resource 
~ per resource of type LAN or type RING 


Alert records 


SNA-unique data (RECFMS 01, 05) per 
resource (cannot be modified) 


Local area network resources 


100 


Use this command very carefully, because you may inadvertently destroy error 


data. 


This command may not be executed from a multiple entries display. 


This command is not allowed if NetView is installed with the DASD Conservation 


Option. (See “Using the Hardware Monitor” on page 4-4.) 


Example 


To set the event wrap count equal to 100 for the resource UNIT1, enter: 


SW EV 100 N UNIT1 
Response 


The normal response to this command is: 


BNJ2391 WRAP COUNT FOR RESOURCE UNIT1 IS NOW 100 
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6-47 


TEST 


The TEST command causes a test to be conducted of the modems and communi- 
cation facilities to a specified resource. 


The format of the TEST command is: 


where: 


resnamel specifies the name of the communication or network controller from 
which the command is to originate. 


resname2 __ specifies the name of the remote Pu or link station on the link. 


DTE displays the current and transition states of the EIA leads for named. 
LS conducts and displays the results of a link status test. 

RST | conducts a remote modem self test. 

LSL1 conducts the test on link segment level 1. This is the default. 

LSL2 conducts the test on link segment level 2. 

MLS conducts the modem and line status test. 

LA displays the analog operands of a line. 

TRI causes a modem pair to exchange one or more sequences of prede- 


fined bit patterns over the line. 
no the number of test sequences the modem should exchange. Only 
valid with the TRT operand. 


Usage Note 


The operands DTE, LS, and RST work with the 386x family of modems or the 586x 
family of modems with the line specified as LPDA-1. 


The operands LSL1, LSL2, MLS, LA, and TRT work with the 586x family of modems only 
with the line generated as LPDA-2. 


The results of the test are not recorded in the hardware monitor data base. 


If you enter an incomplete TEST command, you will be prompted for missing oper- 
ands. For resource names, any non-hardware-monitor command (except NCCF) will 
be taken as a resource name. 


When issuing a TEST command to display the state of the EIA leads, the current state 
of the DTR, CTS, RD, or RLSD lead cannot be detected if it is tied to signal ground. 
This is due to isolation circuitry in the modem hardware. 


Several error situations are possible if you enter more than the information for 


which you are being prompted and if there is a mismatch between the line gener- 
ation and the type of LPDA option you are entering: 
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e If you entered a valid LPDA-1 option (DTE, RST, or LS) in addition to the requested 
resource names, and the line is generated for LPDA-2, a SNA negative response 
results and the command display NPDA-10AA is presented. 


e {If you entered a valid LPDA-2 option (LA, TRT, or MLS) in addition to the requested 
resource names, and the line is generated for LPDA-1, the TEST prompting panel 
is redisplayed with error message BNJ1610I. 


This command is not allowed if NetView is installed with the DASD Conservation 
Option. (See “Using the Hardware Monitor” on page 4-4.) 


Example 


If the line specified is LPDA—2 and you enter TEST NMOD90 PosoosA, the hardware 
monitor prompts you for MLS, LA, or TRT. 


To run a link status test on the link from the communication or network controller 
CTRL1 to the PU named RALO1, enter: 


TEST CTRLT RALOI LS 
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TOP 


The ToP command displays the first page of a multiple-page display. 


The format of the TOP command is: 


Usage Note 
If you enter this command for a single-page display, no change occurs. 


PF4 is set to the TOP command if the PFKDEF CLIST is invoked. (Ask your lead oper- 
ator whether your default PF key settings are established.) 


This command is not allowed if NetView is installed with the DASD Conservation 
Option. (See “Using the Hardware Monitor” on page 4-4.) 


Example 


To display the first page, enter: 
TOP 
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TOTAL 


The TOTAL command displays the count of event or statistical records for a speci- 
fied resource or resource type. If no resource name or type is specified, a 
summary is displayed. 


The format of the TOTAL command is: 


Total {Ev|ST} T type 
N resname 
A adaptadr 
where: 
EV specifies event records. 
ST specifies statistical records. 
T specifies that the operand that follows is a resource type. 
type specifies resource type. 
N specifies that the operand that follows is a resource name. 


resname specifies the symbolic name of the resource. You can specify up to 
five resource names to fully qualify the resource for which data is to 
be displayed. 


A identifies that the operand that follows is an adapter address. 
adaptadr specifies the 12 hexadecimal digit adapter address. 

Usage Note 

If the name of the resource is not associated with a unique resource configuration 
on the data base, then a selection panel will be displayed on which the user can 


choose which configuration is relevant. 


This command is not allowed if NetView is installed with the DASD Conservation 
Option. (See “Using the Hardware Monitor” on page 4-4.) 


Example 


To display the total statistical records for UNIT1 enter: 
TOT ST N UNIT] 
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The ? (question mark) command displays the definition of any term or phrase used 
as a heading on a hardware monitor display. | 


The format of the ? command is: 


where: 


phrase specifies the term or phrase. 
Usage Note 


The term or phrase may be truncated as desired. The search is performed on the 
same number of characters that you enter. 


The ? command must be entered on a hardware monitor display that uses the 
phrase. 


This command is not allowed if NetView is installed with the DASD Conservation 
Option. (See “Using the Hardware Monitor” on page 4-4.) 
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uvs vse 4700 Support Facility Command Descriptions 


The commands that follow can be used with the 18M 3600/4700 Finance Communi- 
cations Systems. They can be run under MVS and VSE. 
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MVS VSE ALLC 


The ALLC command displays a list of the 3600 and 4700 controllers in the network. 


The format of the ALLC command is: 
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MVS VSE BACK 


The BACK command displays the previous page of a multipage panel. 


The format of the BACK command is: 


BACK 


Usage Note 
You cannot go backward past the first page. PF7 is set to the BACK command if the 


PFKDEF CLIST is invoked. (Ask your lead operator whether your default PF key set- 
tings are established.) You can only go back one page at a time. 
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uvs ve COMMAND 


The COMMAND command displays a list of all commands that you can use in the 
4700 Support Facility. 


The format of the COMMAND command is: 
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MVS VSE COPY 


The Copy command prints a copy of the panel on your screen to your printer if it is 
active, or to your network log if it is active. 


The format of the COPY command is: 


COPY 


Usage Note 


Messages are displayed at the operator’s terminal to indicate success or failure of 
the COPY operation. 


Example 


To make a copy of the panel you are displaying, enter: 
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MVS VSE CTRL 


The CTRL command displays a summary of the data and status associated with a 
specified 3600 or 4700 controller and its resources. 


The format of the CTRL command is: 


where: 


ctriname the physical unit (PU) name of the controller. 
Example 


To view the summary display for controller CTRLO1, enter: 


CTRL CTRLOL 
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uvs vse DISPLAY 


The DISPLAY command displays the current 4700 Support Facility operational oper- 
ands associated with the specified controller. 


The format of the DISPLAY command is: 


pisplay {( wRAP 


,wrapid 7: 
,ctriname,resname 


THRESH | 


where: 
WRAP 


wrapid 


ctriname 


resname 


THRESH 
threshid 


Usage Note 


jthreshid 
,ctriname,resname 


specifies a current wrap count. 

indicates the type of wrap count to be displayed. Valid wrapids are: 
ERROR—displays error wrap count 
RESP—displays response time wrap count 
STATUS—displays status wrap count. 

identifies the specific controller about which data are to be displayed. 


identifies the specific resource or group of resources attached to the 
ctriname about which data are to be displayed. Valid resources are: 


loopname 
wsname 
ALL (all loops or workstations) 


If both ctriname and resname are included, they must be separated 
by acomma. 


specifies a current threshold value. 


indicates the type of threshold value to be displayed. Valid threshids 
are: 


ERROR—displays Loop Basic Counter 2 and extended counter 
threshold values 


RESP—displays response time threshold values. 


Together, ctriname and resname identify the specific resources for which data is to 


be displayed. 
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Example 


To display the threshold values for controller CTRLO1 and resource LP02, enter: 
DISPLAY THRESH, ERROR,CTRLO1,LPO2 
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MVS VSE EN D 


The END command is used to leave the 4700 support facility. 


The format of the END command is: 


End : 7 [ALL] _ 


where: 

all terminates the 3600 feature, hardware monitor and all other 
hardware monitor features running in this session with 
command facility. 

Usage Note 


The abbreviation for this command is E. PF2 is set to the END command if the PFKDEF 
CLIST is invoked. (Ask your lead operator whether your default PF key settings are 
established.) 
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uvs ve FORWARD 


The FORWARD command displays the next sequential page of a multipage display. 


The format of the FORWARD command is: 


Usage Note 


If you enter F on the last page of a multiple page display, you will go to page 1 of 
the display. 


This command can be abbreviated as F or FORW. PF8 is set to the FORWARD 
command if the PFKDEF CLIST has been invoked. {Ask your lead operator whether 
your default PF key settings are established.) 


Example 


To move ahead one page, enter: 
FORWARD 


If there are more pages in the current display, you will see displayed the next page 
after the current page. 


6-62 NetView Operation 


uvs vse HELP 


The HELP command provides you with directions for moving from panel to panel in 
a multipage display, or for moving through the hierarchy of the 4700 Support 
Facility panels. 


The format of the HELP command is: 
Help 
Usage Note 


PF1 iS set to HELP if the PFKDEF CLIST is invoked. (Ask your lead operator whether 
your default PF key settings are established.) 
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MVS VSE LOO Pp 


The Loop command displays the most recent status and error data for a 3600 or 
4700 controller loop. 


The format of the LOOP command is: 


“be loopnamal Poe ee 


where: 
STAT specifies status data. 
ERROR specifies error data. 


ctriname specifies the physical unit name of the controller to which the loop 
is attached. 


loopname specifies the loop name (LPnn) of the loop. 
Usage Note 

Data is presented in reverse chronological order. 
Example 


To view detailed error data for controller CTRLO1 and loop LPo2, enter: 


LOOP ERROR.CTRLOI. LPOZ 
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The MENU command displays the 4700 Support Facility main menu panel. 


The format of the MENU Command is: 


Menu 


Example 


To display the first panel of the 4700 support facility, enter: 


BET AS 
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uvs vse RESUME 


The RESUME command returns to the 4700 Support Facility panel. from which you 
issued a command that took you to another NetView component. 


The format of the RESUME Command is: 


Usage Note 


The RESUME operation can also be done simply by entering the TARA command 
while in another component. 
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uvs vse RETURN 


The RETURN Command presents the last panel that you viewed at the previous level 
in the panel hierarchy of the 4700 Support Facility. ° 


The format of the RETURN Command is: 
Return 


Usage Note 


If the present display was created by using an explicit command, the RETURN 
command displays the Menu panel. 


PF3 is set to the RETURN command if the PFKDEF CLIST is invoked. (Ask your lead 
operator whether your default pF key settings are established.) 
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MVS VSE S ET 


The SET command allows you to adjust the 4700 Support Facility operational oper- 
ands associated with the specified controller. 


The format of the SET command is: 


where: 
THRESH 
threshid 


ctriname 


resname 


thrshval 
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specifies that a new threshold value is to be set. 
indicates the type of threshold value to be set. Valid threshids are: 
BASIC2 Set the Loop Basic Counter 2 threshold value. 


EXTEND Set the threshold value for the extended statistical counter 
specified by the resname operand. 


RESPAVG Set the average response time threshold for the work- 
station specified by the resname operand. 


RESPMIN The minimum number of times that the response measure- 
ment must occur before the response time received is 
compared to the user-defined average threshold value. 


identifies the specific controller which 4700 Support Facility opera- 
tional operands are to be set. 7 


identifies the specific resource or group of resources attached to 
ctriname about which data are to be displayed. Omit this operand 
when issuing the SET PARM, INTERVAL Command. Valid resources are: 


loopname (not valid for PARM option) 
wsname 
ALL (all loops or workstations) 


the new threshold value, expressed as one to four decimal digits, 
which have the following meanings: 


Loop Basic Counter 2: 123 = 123 Errors/Hour 
Extended statistical counters: 123=1.23% error rate 


Workstation response time: 123 = 12.3 seconds. 


PARM specifies that a change is to be made to a CNM/CS operational 
operand. When PARM is used to change the active interval timer, the 
4700 Support Facility shuts off all timers defined for that resource and 
then activates the specified timer. The resname information should 
be omitted when issuing the SET PARM, INTERVAL command. 


parmid indicates the operand to be changed. Valid operands are: 


TIMER—Activate the timer named by the name operand on the 
workstation specified by ctriname and resname 


INTERVAL—Set the interval for monitoring loop status changes. 


name the symbolic names of the timers to be set on. The name operand is 
used only with SET PARM, TIMER. 


count the new value to be used as the loop status monitor interval. The 
value is expressed as one to four decimal digits, where 123 = 123 
seconds. The count operand is used only with SET PARM, INTERVAL. 


WRAP specifies that a new wrap count is to be set 
wrapid specifies the type of wrap count to be set. 


Valid wrapids are: 


STATUS 
ERROR 
RESP 


wrpcnt new wrap count value. Expressed as one to four decimal digits 
where 123 = 123 records. 


Usage Note 


Together, ctriname and resname identify the specific resources for which a 
threshold is to be set. 


Example 


To set an error wrap count of 25 for Lpo2 attached to CTRLO01, enter: 


SET WRAP, ERROR, CTRLOE,LPOZ.25 
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MVS VSE SOLICIT 


The SOLICIT command requests data and status from the Communications Network 
- Management Controller Support in the specified 3600 or 4700 controller. 


The format of the SOLICIT command ts: 


where: 

ctriname specifies the PU name of the controller. 

ERROR specifies loop error statistics. This is the default. 

STAT specifies loop status. 

RESP specifies response time data. 

ALL specifies RESP, STAT, and ERROR data. 

BATCH specifies all basic counters, all extended statistical counters, and 
controller system log entries. 

NONOTIFY specifies that you are not to receive a successful completion | 
message. This is the default. 

NOTIFY specifies that you are to receive a successful completion message. 

Usage Note 


The primary use of this command is in timer-initiated CLISTs. 


It is not necessary to precede this command with TARA. You can enter it in CLISTs or 
directly from command facility. 


This command does not have an associated display; it is used solely for the col- 
lection and recording (with the exception of the BATCH option) of CNM data in the 
4700 support facility VSAM file. 


You should not use the BATCH operand unless the system programmer has pro- 
vided the NetView exit routine DSIEX06 or xiTCI to process this data. 


Whether you specify NOTIFY Or NONOTIFY, you receive a message if the request was 
unsuccessful. 


Example 


To request response time data for CTRLO1, enter: 
SOLICIT CTRLO1, RESP 
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uvs ve SYSMON 


The SYSMON command provides access to the system monitor in the specified 3600 
or 4700 controller. 


The format of the SYSMON command is: 
SYSMON ctriname 


»MESSAGE, text — 
,LOGON,password 


command — 
,ATIN 
where: 
ctriname specifies the name of the Pu. 


MESSAGE _ specifies that a message is to be sent to the operator who is currently 
logged on to the system monitor facility. Messages may also be sent 
to a command facility operator by a 3600/4700 operator logged on to 
the system monitor facility. 


text specifies the message text, can be from 1 to 120 characters. 
LOGON specifies a request to log on to the system monitor facility. 
password specifies a logon password, from 1 to 16 characters. 

command _ specifies a system monitor command, from 1 to 120 characters. 


ATTN request an attention interrupt to the system monitor. This is the same 
as pressing the ENTER key on the keyboard attached to the 4700 
Support Facility. This is the default. 


Usage Note 


lf the system monitor is not currently in use, you can log on to the system monitor. 
You can then issue system monitor commands. Only one operator or application 
may be logged on to the system monitor at a time. The local 3600 or 4700 operator 
has priority and can log off a host network operator. 


It is not necessary to precede this command with TARA. You can enter it in CLISTs or 
directly from command facility. Refer to 3600 Finance Communication System: 
Operating Reference Manual and 4700 Finance Communication System: Subsystem 
Operating Procedures manual for a discussion of 3600 and 4700 system monitor 
commands. 


i 
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uvs vse TARA 


The TARA command enters the 4700 Support Facility, or is used to process a single 
4700 Support Facility command from another NetView component, or to page 
forward one page on a multiple-page display. 


The format of the TARA command is: 
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uvs vse TCTRL 


The TCTRL CLIST displays a summary of the data and status associated with a speci- 
fied 3600 or 4700 controller and its resources. 


The format of the TCTRL CLIST is: 


TCTRL ctriname 


where: 


ctriname specifies the physical unit name of the controller. 

Usage Note 

This command generates a CTRL command. See page 6-64 for more information. 
Example 


To display summary data and status for controller CTRLO1, enter: 


reli erg a4 
rey ms oot fag 
Pie PL APL 
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MVS VSE TER R 


The TERR CLisT displays error data for a 3600 or 4700 loop. 


The format of the TERR CLIST is: 


where: 


ctriname specifies the physical unit name of the controller to which the loop is 
attached. 


loopname _ specifies the name (LPnn) of the loop. 

Usage Note 

This CLIST generates a LOOP command. See page 6-64 for more information. 
Example 


To display error data for controller CTRLO1 and loop LPo2, enter: 


TERR CTRLO1, LPO2 ” 
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MVS VSI TOP 


The Top command displays the first page of a multipage display. 


The format of the TOP command is: 
TOp. 


Usage Note 


PF4 is set to the TOP command if the PFKDEF CLIST is invoked. (Ask your lead oper- 
ator if your default PF key settings are established.) 


Example 


To display the first page, enter: 
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uvs vse TSTAT 


The TSTAT CLIST displays the most recent status data for a 3600 or 4700 loop. 


The format of the TSTAT CLIST is: 


where: 


ctriname specifies the physical unit name of the controller to which the loop is 
attached. 


loopname _ specifies the name (LPnn) of the loop. 

Usage Note 

This CLIST generates a LOOP command. See page 6-64 for more information. 
Example 


To display the most recent status data for controjler CTRLO1 and loop LPo2, enter: 
TSTAT CTRLOI,LPO2 
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MYS VSE TTERR 


The TTERR CLIST returns current 4700 Support Facility threshold values for the loop 
basic counter 2 and extended counters for a// loops attached to the specified 3600 
or 4700 controller. 


The format of the TTERR CLIST is: 


TTERR ctriname 


where: 

ctriname the controller for which you want current threshold values. 
Usage Note 

This CLIST generates a DISPLAY command. You should use that command if you 
want to restrict data to a specific loop or workstation. See page 6-59 for more 
information. 


Example 


To display the current threshold value for controller CTRLo1, enter: 


Tipe Cee 
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uvs vse | TRESP 


The TTRESP CLIST returns 4700 Support Facility response time threshold values for 
all workstations attached to the specified controller. 


The format of the TTRESP CLIST is: 


where: 

ctriname the controller for which you want current response time threshold 
values. 

Usage Note 


This CLIST generates a DISPLAY command. You should use that command if you 
want to limit data to a specific loop or workstation. See page 6-59 for more infor- 
mation. 


Example 


To display the current response time threshold value for controller CTRLO1, enter: 
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MVS VSE TWE R R 


The TWERR CLIST returns the error wrap count for ALL loops attached to the specified 
3600 or 4700 controller. 


The format of the TWERR CLIST is: 


TWERR ctriname 


where: 

ctriname the controller for which you want error wrap counts. 

Usage Note 

This command generates a DISPLAY command. You should use that command if 
you want to limit data to a specific loop or workstation. See page 6-59 for more 
information. 


Example 


To display the error wrap count for controller CTRLO1, enter: 
TWERR, CTRLO1 
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uvs vse F|WKSTA 


The TWKSTA CLIST displays the 4700 support facility most recent workstation 
response time data. 


The format of the TWKSTA CLIST is: 


where: 


ctriname specifies the physical unit name of the controller to which the work- 
station is attached. 


wsname specifies the name of the workstation whose response time data is to 
be displayed. 


Usage Note 
This CLIST generates a WKSTA Command. See page 6-83 for more information. 
Example 


To display the most recent response time data for controller CTRLO1 and workstation 
wso2, enter: 


TWKSTA CTRLO1, WSO2 


6-80 NetView Operation 


uvs vse TWRESP 


The TWRESP CLIST returns response time wrap count for all workstations attached to 
the specified 3600 or 4700 controller. 


The format of the TWRESP CLIST is: 


TWRESP-_ Cirilname 


where: 

ctriname the controller for which you want response time wrap counts. 
Usage Note 

This CLIST generates a DISPLAY command. You should use that command if you 
want to limit data to a specific loop or workstation. See page 6-59 for more infor- 
mation. 


Example 


To display the response time wrap count for controller CTRLO1, enter: 
TWRESP CTRLO1 
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uvs vse TWSTAT 


The TWSTAT CLIST returns the current status wrap count for all loops attached to the 
specified 3600 or 4700 controller. 


The format of the TWSTAT CLIST is: 


where: 


ctriname the controller for which you want current status wrap counts. 

Usage Note 

This CLIST generates a DISPLAY command. You should use that command if you 
want to limit data to a specific loop or workstation. See page 6-59 for more infor- 
mation. 


Example 


To display the status wrap counts for controller CTRLO1, enter: 
TWSTAT CTRLO1 
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MVS VSE WKSTA 


The WKSTA command displays the most recent 4700 Support Facility workstation 
response time data. 


The format of the WKSTA command is: 


WKSTA ctriname ,wsname 


where: 


ctriname specifies the physical unit name of the controller to which the work- 
station is attached. 


wsname specifies the name of the workstation whose response time data is to 
be displayed. 


Usage Note 
Data is displayed in reverse chronological order. 
Example 


To display most recent response time data for controller CTRLO1 and workstation 
wso2, enter: 


WKSTA CTRLOI,WSO2 
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Chapter 7. Acquainted with the Session Monitor 


The session monitor (NLDM) collects and correlates data about System Network 
Architecture (SNA) sessions. The session monitor also helps identify network prob- 
lems and conditions that might cause errors. Some examples of this are failing or 
unresponsive terminals, lost path information units (Pius), buffer errors, and 
resource status errors. You can display the collected session monitor data by 
using a sequence of session monitor panels. 


The session monitor collects data about same-domain, cross-domain, and cross- 
network SNA sessions, and maintains the collected data on a session basis. The 
SNA sessions may involve non-SNA terminals supported by Network Terminal Option 
(NTO). These NTO sessions appear to the host as normal SNA sessions. The session 
monitor also collects data about data flows for certain non-SNA terminals that are 
not supported by NTO. To collect data for cross-domain sessions, either a session 
monitor or an NLDM must be available in each domain. To collect data for cross- 
network sessions, either a session monitor or an NLDM must be available in each 
gateway host on the session path and at session end points. 


Data Collection 
The session monitor collects the following types of data: 


e Session Awareness Data 

e Session Trace Data 

e Session Response Time Data 

e Route Data 

e Network Accounting and Availability Measurement Data. 


The data is stored in virtual memory and at session end written to the VSAM data 
base. See Figure 7-1 on page 7-2 for an overview of the sources of session 
monitor data. 
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Figure 7-1. Session Monitor Data Collection 


Session Awareness Data 
Session awareness data is information about session activity within the networks. 
This data identifies the partners of each session, which can be in the same domain, 
in different domains, or in different networks. 


When the session monitor is active, session awareness data is collected whenever 
a session begins or ends. Session awareness data consists of information from 
VTAM, such as session activation status, the session type, the names of the session 
partners, and session configuration data. Activation status includes BIND failure, 
UNBIND reason and sense codes, and INIT failure. Session partners can be: 


e Logical unit to logical unit (LU-LU) 

e System services control point to logical unit (SSCP-LU) 

e System services control point to physical unit (SSCP-PU) 

e System services control point-system services control point (SSCP-SSCP). 


Session awareness data includes information about the activation status for certain 
non-SNA terminals not supported by the Network Terminal Option (NTO). 


7-2 NetView Operation 


Session awareness data is displayed in various forms. Some examples are 
resource lists, domain lists, session histories for specific resources, and session 
configuration diagrams. Session awareness data is required for all other types of 
data collection. 


Session Trace Data 
Session trace data consists of session activation parameters, VTAM path informa- 
tion unit (PIU) data, and network control program (NCP) data. 


Before the session monitor collects session trace data, a session trace must be 
started. It is possible to start trace for a resource before it is activated. Once trace 
is started for a node, the session monitor remembers to trace the node if it is deac- 
tivated and then activated again. NCP gateway trace data does not depend on trace 
activation status. 


You can display the parameters used in session activation. Session activation 
parameters are those parameters included in the SNA command used to activate 
the session. BIND, activate physical unit (ACTPU), activate logical unit (ACTLU), and 
activate cross-domain resource manager (ACTCDRM) are examples of those com- 
mands. The session activation parameters can be displayed in hexadecimal or 
text representation. 


You can display two types of NcP trace data for sessions involving NcP-attached 
resources. They are boundary function trace data and gateway trace data. 
Boundary function ncP data consists of the last four Plu sequence numbers (the last 
two outbound and last two inbound) and selected fields from control blocks passed 
to the session monitor from the ncp. (These fields are described in NcP and EP Ref- 
erence Summary and Data Areas.) Gateway ncp data consists of the last four PIU 
sequence numbers (the last two outbound and the last two inbound) to cross the 
gateway NcP. It also contains all control blocks sent from the gateway NcP. The 
NcP control blocks displayed depend on the type of resource in the session. 


You can display VTAM path information unit (Piu) data of all sessions for which the 
session monitor collects session trace data. PiU data includes the transmission 
header (TH), the request/response header (RH), and the request unit (RU). Trun- 
cated Pius will have a maximum of eleven bytes of the RU displayed; otherwise the 
complete Piu will be displayed. Piu data can be displayed in hexadecimal or text 
representation. 


Pius that are discarded by vTAM are transferred to the session monitor for trace 
processing. These Pius fall into two main categories: 


¢ Pius that are associated with a specific active session and are discarded 
because of a protocol violation; for example, an invalid data count field (DCF) 


e pius that are discarded because they are not associated with a specific active 
session; for example, extraneous traffic. 


in each case, the session monitor retains copies of the discarded Pius ina 
“pseudo-session” trace buffer. Using the command SESS “DISCARD, this buffer can 
be accessed. The Pius in this area are associated with many different sessions, so 
no session parameters or session configuration data is available. However, 
selection from the SESS panel will display the trace data. The size of the “DISCARD 
area is specified by the NLDM KEEPDISC initialization statement. The “DISCARD data is 
not saved in the VSAM file when the session monitor is brought down unless the 
save is set up by a FORCE command. This may be used with a timer-driven CLIST. 
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If associated with a specific session, Pius discarded by the access method are 
inserted in the active session’s PIU wrap area. The discarded PiU can then be 
examined in the context of that session’s PiU flow. If the PiU is discarded from this 
area (because of session activity), a copy may still exist in the “DISCARD file. 


Session Response Time Data 


Route Data 


Session response time data is measured and accumulated by control units having 
the response time monitor (RTM) feature. The session monitor collects the 
response time data on command and displays it in various formats. The control 
units accumulate the measured response times into ranges of time that are speci- 
fied by the performance class definitions. Sessions are associated with certain 
performance classes, and each performance class has associated with it a specific 
response time objective. Response time graphs can be displayed that show how 
the actual response time compares to a specified objective. 


Response time data is displayed in: 


e Response time summary for a terminal Lu 
e Response time trend for a terminal LU 
e Response time for a session by collection period. 


Response time and configuration data for each session can be written to an 
external log as the response time data is collected, allowing other programs to 
process it. 


Active route data is collected whenever a route is first used by a session. The 
route information includes a list of PUSs and TGs that make up the explicit route. The 
session monitor allows an operator to view the route and then proceed into the 
session hierarchy on a route by route basis. 


Active route data is displayed in the following ways: 


e Active explicit route list 

¢ Active virtual route list 

¢ Active virtual route status 

e Explicit route configuration 

e Transmission group information. 


Network Accounting and Availability Measurement Data 


Network Accounting and Availability data measurement provides you with network 
availability data and distribution of usage of network resources. This function must 
be started at the time the session monitor is initialized. The measured data is 
written to an external log by the RECORD command and at session end for off-line 
processing. See NetView Installation and Administration Guide for more informa- 
tion. 


Starting the Session Monitor 


7-4 NetView Operation 


The session monitor will most often be started when the NetView program is 
started. However, if your installation chooses to start them separately, NetView 
must be started first. You can then start the session monitor (NLDM), by entering: 


STARTCNM NLDM 


Session Monitor Warm Start 


After NetView is active, the session monitor can be started and stopped separately 
from NetView. Restarting the session monitor this way is called warm starting. 
When the session monitor is warm-started, session awareness data is received 
only for active sessions that were started before task AAUTSKLP was ready to 
receive data. Task AAUTSKLP may not receive session awareness data if: 


¢ SAW=NO was specified in AAUPRMLP. In this case, use the ENABLE command to 
start the session awareness data. 


e Task AAUTSKLP was not started until the sessions were active. In this case, use 
the START TASK command to initialize AAUTSKLP. 


The session monitor will never receive session awareness data for sessions that 
begin and end before task AAUTSKLP is ready to process the data. Session parame- 
ters are not saved by VTAM so they are not available for sessions that are active 
when NLDM is warm-started. For active sessions, trace data and response time 
data are available only from the time of the warm start and not before. 


Using the Session Monitor 


To use the session monitor (NLDM), enter the command: 


NOM 


Terminals that support extended data streams (for example the IBM 3279) will 
present information in color. 


The session monitor does not provide wide-screen (63 x 180) support. Information 
on these displays is in 24 x 80 format. The supported display sizes are: 24 x 80, 27 
x 80, 32 x 80, and 43 x 80. 


The next panel displayed is the NLDM.MENU panel: 


NLDM.MENU NETVIEW PAGE 1 
DOMAIN D1234 
SEL# DESCRIPTION 
(1) LUNAME LIST LIST OF ALL ACTIVE LOGICAL UNIT NAMES 
( 2)  SLUNAME LIST LIST OF ACTIVE SECONDARY LOGICAL UNIT NAMES 
( 3) PLUNAME LIST LIST OF ACTIVE PRIMARY LOGICAL UNIT NAMES 
( 4) PUNAME LIST LIST OF ACTIVE PHYSICAL UNIT NAMES 
( 5) SSCPNAME LIST LIST OF ACTIVE SSCP NAMES 
( 6) DOMAIN LIST LIST OF NLDM DOMAINS 
(7) ER LIST | LIST OF ACTIVE EXPLICIT ROUTES 
( 8) 


~ CMD==> 


VR LIST LIST OF ACTIVE VIRTUAL ROUTES 


ENTER: H OR HELP FOR INFORMATION ON THE USE OF NLDM 


HELP NLDM COMMANDS FOR NLDM COMMAND LIST 


oo NLDM FILE LAST. INITIALIZED. 05/24/87 


"ENTER SEL# OR COMMAND 


Figure 7-2. Session Monitor Menu Panel 


Chapter 7. Getting Acquainted with the Session Monitor 7-5 


From the NLDM.MENU panel you can select one of the listed options, request help 
information, or enter any NetView command. 


Entering Commands 
~ Session monitor commands that are entered from within the session monitor need 
not be prefaced with NLDM. For example, to enter the List command, type: 
LIST 


When session monitor commands are entered from outside the session monitor, 
you must preface them with NLDM. For example, to enter the LIST command from 
the hardware monitor, type: 


NLDM LIST 


Some session monitor commands require operands, such as the SESS command. 
Operands are optional for commands such as BACK, FORWARD, SET HEX, and LIST. For 
specific information on these operands, see the command descriptions in 

Chapter 9, “Session Monitor Command Descriptions” on page 9-1. 


Panel Layout 


In panel mode, the panel has four sections: 


e Level of Hierarchy and Panel Title - Sectio 
e Information Display Area - Sectio 
e Message Area - Section: =. 

¢ Command Entry Area - Section’ 


Refer to Figure 7-2 on page 7-5 as you read about each section. 


Level of Hierarchy and Panel Title 
Section: - contains the level of hierarchy and panel title line. If this panel is part 
of a multiple page display, the page number is shown in the right corner of the 
display. 


Information Display Area 


Section. lists the information you requested. 


Message Area ; 
Section .° contains the message area. This area is reserved for messages such 
as prompt messages and error messages. 


Command Entry Area 


bottom of your panel to the right of cuD= = >. This is where you enter commands 
or selection numbers. 


7-6 NetView Operation 


Moving through the Hierarchy 


Session monitor functions are presented in a sequence of panels. Figure 7-3 on 
page 7-8 shows the sequence of panels through which you can move. Certain 
commands (listed in the left column of the figure) can be used to access a panel 
directly, without going through the hierarchy. For example, you can use the RTREND 
command to go directly to the Response Time Trend panel. 


The panels that are not within the hierarchy can be displayed only by issuing the 
appropriate command. 


You can move up or down in the hierarchy of panels by using PF keys or the 
prompts shown with each display. When you select panels by going through the 
hierarchy, you can use the RETURN Command (or PF3) to go back to the previous 
panel. When you use a command to go directly to a certain panel from within the 
session monitor, the RETURN Command brings you back to the MENU panel. (If you 
use the SENSE Command, you will go back to the previous panel.) 
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Figure 7-3. Session Monitor Panel Hierarchy 
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7-8 NetView Operation 


The panels in Figure 7-3 on page 7-8 can be used as follows: 


Menu 
Allows you to select the type of resource list, list of domains, active 
explicit routes (ERS), or active virtual routes (vRs) for which you want 
information. 


Resource Name List 
Displays a list of resources for which data is available. From this 
panel, you can view response time summary, response time trend, or 
session series. 


Response Time Summary 
is a series of graphs showing the percentage of transactions in each 
response time range for a specified period of time. This is done fora 
specific logical unit in a given domain. This may be a multiple page 
display. There are different pages for the various performance 
classes. 


Response Time Trend 
ls a graph for a specific terminal logical unit that shows the per- 
centage of transactions with response times that are less than a spec- 
ified maximum objective for each data collection period. You can 
specify a maximum or your system programmer can set up the limits. 
The objective is displayed on the panel. 


Session Series 
Shows a list of sessions for which the resource(s) you name on the 
command are or have been in session with. From this panel, you can 
view session configuration data, start a session connectivity test for 
an active session, or display the reason code and sense code for an 
inactive session. 


Session Termination Reason 
Presents in detail a description of the reason codes and sense codes 
associated with UNBIND, BIND failures or INIT failures. 


Configuration Services-Session Configuration 
Shows the local network configuration for a selected session. You 
can shift the panel to the left (PF10) or right (PF11) for adjacent network 
configurations. From this panel, you can display trace information, 
session parameters, explicit route information, session response time 
or active virtual route status. 


Configuration Services-init Failure Configuration 
Shows the configuration of sscps that attempted to establish the 
selected failed session. Note this function depends on the session 
monitor being fully functional in each sscp that attempted to establish 
the session. | 


Parameter Series 
Displays the session parameters for a given session. You can have 
the information interpreted or displayed in hexadecimal. 


Session Response Time 
Is a graph of the percentage of transactions in each response time 
range for each data collection period of a session. Each data col- 
lection period is a separate page, beginning with the earliest period. 
To display the most recent period, enter the BOTTOM command. 
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Trace Series | 
Provides trace data for the type of trace you requested on the pre- 
vious panel. Whether you will get a formatted or unformatted list 
depends on the trace you requested and whether you have HEx set on 
or Off. 


Explicit Route Configuration 
Provides a configuration for an explicit route. Explicit route informa- 
tion includes the translation of subarea Pu addresses into network 
names, wherever possible. From this panel, you can select a panel 
to view transmission group detail information. 


Transmission Group 
Displays a list of all the sscps that have activated links on either side 
of the selected transmission group. If SSCP names are not available, 
their subarea addresses are displayed, in EBCDIC. 


Active ER List 
Lists the active explicit routes for which data is available. From this 
panel, you can display a list of sessions using a specific explicit route 
or display the configuration of the explicit route. 


Active VR List 
Lists the active virtual routes for which data is available. From this 
panel, you can display the virtual route status, display a list of ses- 
sions, or display the configuration of the explicit route. 


Virtual Route Status 
Lists the virtual route status data from the virtual route end points. 


Active Domain List 
Lists other known domains. It also shows the status of sessions that 
have been started to each of these domains. 


Sense Code Description 
Presents in detail a description for sense codes. 


Display Keep 
Lists the PiU KEEP counts that have been set for a specific network 
name or for a name pair. 


Display Trace 
Lists the specific resource names that have been 
activated/deactivated for tracing with the TRACE command. The first 
resource listed (GLOBAL) reflects the setting of the TRACE ALL function. 
If global trace is ON, TRACE STOP can be used to deactivate the trace for 
all sessions with the specified resource. The session monitor lists the 
specific network names that have been deactivated. If global trace is 
OFF, the TRACE START can be used to activate the trace for all sessions 
with the specified resource. The session monitor lists the specific 
resource names that have been activated. 


Help 
Lists and describes the session monitor commands for which online 
help is available. 

Help Group 
Describes the syntax of the command selected from the previous help 
panel. | | 


7-10 NetView Operation 


For explanations of the fields shown on the panels, see Appendix B, “List of Panel 
Fields” on page B-1. To receive online help information for a particular panel you 
can enter the following command: 


HELP NLDM. pane iname 


where pane/name is the name of the panel, found in the upper left corner of each 
session monitor panel. For example, to receive help on the panel in Figure 7-2 on 
page 7-5, you would enter: 


HELP NLDM.MENU 


To leave the panel hierarchy and return to the command facility, enter END or press 


PF2. 


HELP NLDM is not allowed if NetView is installed with the DASD Conservation Option. 


Program Function Keys for the Session Monitor 


In the session monitor, the defaults for the program function keys 1-12 are as 


follows: 
PF1 HELP 
PF2 END 


PF3 RETURN 


PF4 TOP 
PF5 BOTTOM 
PF6 ROLL 


PF7 BACK 
PF8 FORWARD 
PF9 NCCF 


PF10 LEFT 


PF11 RIGHT 


PF12 RETRIEVE 


Displays help information. 


Causes the system to return to the component that the 
operator was using before entering the current one. 


Causes the system to return to the point from which this 
panel was requested. 


Displays the first page of a multiple-page panel. 
Displays the last page of a multiple-page panel. 


The system remembers the sequence in which you go from 
one component to another. When you use the ROLL PF key, 
the system moves the name of the current component to 
the beginning of this sequence, and re-enters the compo- 
nent at the end of the sequence. 


Displays the previous page of a multiple-page panel. 
Displays the next page of a multiple-page panel. 


Sends the command you entered directly to the command 
facility (NCCF). 


Shifts the panel to the left over the Session Configuration 
Data display. 


Shifts the panel to the right over the Session Configuration 
Data display. 


Displays the most recently entered session monitor 
command. 
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Online Help Information 


To get online help for the session monitor (NLDM), enter: 
HELP NLDM 


HELP NLDM is not allowed if NetView is installed with the DASD Conservation Option. 
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Chapter 8. the Session Monitor Commands 


This chapter illustrates some of the capabilities of the session monitor (NLDM). For 
specific command syntax or for more information, see Chapter 9, “Session 
Monitor Command Descriptions” on page 9-1. You can also receive online help 
information on the session monitor commands by entering the following command: 


HELP NLDM COMMANDS 


HELP NLDM is not available if NetView is installed with the DASD Conservation Option. 


Getting to the Session Monitor 


If the session monitor is not already started, use the STARTCNM command to start 
the task. Then use the NLDM command to get to the session monitor. 


Panel Commands 


Use the following panel control commands to move from page to page ina 
multiple-page display. The commands are: 


¢ BACK (page 9-5) 
Displays a previous page. 
e FORWARD (page 9-15) 
Displays a following page. 
e TOP (page 9-45) 
Displays the first page. 
¢ BOTTOM (page 9-6) 
Displays the last page. 
You can use the following commands while you are using the session monitor 
panels. 
e MENU (page 9-22) 
Displays the primary option menu. 
e RETURN (page 9-32) 
Returns you to the previous panel. 
e COPY (page 9-8) 


Prints a copy of the panel that you are viewing. 
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Repeating a Previous Command 


PF12, which provides a RETRIEVE function, causes the last command you entered to 
be placed in the command area. You may then alter the command if you want and 
press the ENTER key to send the command to the system for processing. 


Displaying and Changing PF Keys 


The QUERY PF command (page 9-28) displays the current settings of your PF keys. 
To change the setting of a PF key, use the SET PF command (page 9-42). 


Collecting and Displaying Session Awareness Data 
Use the following commands to display session awareness data: 
e LIST (page 9-20) 
Lists the following session information: 


— Resource names including logical units, primary logical units, secondary 
logical units, physical units, or SSCPs 

— Domain names 

— Active explicit routes 

— Active virtual routes. 


e SESS (page 9-40) 


Lists the sessions for which session awareness data has been recorded that 
have a specified resource as a session partner. 


¢ LINEMAP (page 9-19) 
Displays the ncP line port address associated with a station. 
If you receive any messages that contain sense codes, you can get an explanation 
of these codes by using the SENSE (page 9-39) command. 
Use the following commands to start and stop session awareness data collection: 
e ENABLE (page 9-11) 


Starts data collection. This command also allows the session monitor to 
become aware of any active sessions that may have been started before the 
session monitor was started. 


e DISABLE (page 9-9) 


Stops data collection. 


Collecting and Controlling Session Trace Data 


You can start and stop the collection of session trace data. VTAM and NCP provide 
session trace data to the session monitor only after the session monitor sends a 
request to begin tracing data. You can specify that tracing be started for all 
network resources or for individual network resources. However, to specify trace 
for an individual network resource, the major node must be active. 
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Figure 8-1 on page 8-3 shows the different types of tracing that are available for 
the various resources supported by the session monitor. 


PIU Data & 
Session Session 
Awareness Activation NCP 
Data Parameters Data 
Host LUs associated with user application X X 
programs 
Host SSCP X X 
Channel-attached SNA terminals X X 
Channel-attached non-SNA terminals Xx X 
NTO terminals (includes BSC and X X 
Start/Stop terminals other than 3270) 
NCP-attached SNA terminals (includes X X X 
BSC 3270 terminals) 
NCP-attached PU X X X 


Figure 8-1. Resources That Can Have Sessions Traced 


Use the following commands to collect and control session data: 


TRACE (page 9-46) 


Starts and stops a session trace. You can aiso use this command to display 
which resources are being traced. 


KEEP (page 9-17) 


Allows you to change the number of Piu records that will be kept for a specific 
session. To display the current PiU KEEP counts, uSe DISKEEP (page 9-10). 


SET HEX (page 9-41) 


Displays trace data and the Session Activation Parameters in hexadecimal. If 
the data is already in hexadecimal, this command displays it in text. 


FORCE (page 9-13) 


Writes data to VSAM before a session ends. Normally the data is kept in virtual 
storage until a session ends. 


PURGE (page 9-25) 
Allows the network operator to delete selected data from the vSAm data base. 
PURGEDB (page 9-27) 


Purges session monitor and hardware monitor data. 


Collecting and Displaying Session Response Time Data 


Response time data is collected by a 3174 cluster controller with the response time 
monitor (RTM) feature. The response time is measured for each display station. 
Use the following commands or CLISTs to collect and display the response time 
summary information: 


AUTOCOLL (page 9-3) 
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Gathers response time data from control units. 
¢ COLLECT (page 9-7) 

Gathers response time data from control units. 
e RTSUM (page 9-36) 


For an SNA terminal, displays a graph showing the percentage of transactions 
that took place in each response time range during a specified period of time. 


e RTREND (page 9-34) 
For an SNA terminal, displays a graph comparing the measured times with the 
stated response time objectives during each collection period. 
You limit or check the time range of the data that will be displayed by using the 
following commands: 
e SET RANGE (page 9-43) 
Sets the time range. 
e QUERY RANGE (page 9-29) 


Displays the time range. 


Viewing Session Data in Another Domain 


The session monitor allows you to: 


e Use the SDOMAIN command (page 9-38) to set your terminal to view session 
data that resides in another domain. This is used when data does not pass 
through or terminate in your domain. 


To stop viewing data in another domain and use your terminal to view data 
from the local domain, issue the SDOMAIN command for the domain that con- 
tains your terminal. 


Viewing Session Data in Another Network 


The session monitor allows you to view session data that is in another network. If 
you request a display of session data from a session partner in another network, 
the session monitor coordinates the routing of requests and data between the two 
networks. Cross-network support for the configuration panels provides the com- 
plete session path and alias names. Session data can be routed from any network 
on the session path. 


Recording Accounting, Resource and Session Statistics 
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Use the RECORD command (page 9-30) to send network availability data and infor- 
mation about the distribution of network resources to an external log (for example, 
SMF for Mvs). Event and session counters, and CPU utilization data can also be 
recorded. 


Reloading Definition Statements 


Use the RELOAD command (page 9-31) to reload dynamically the following defi- 
nition statements that are located in DSIPARM: 


PERFMEM RTM performance class definitions 


KEEPMEM KEEP class definitions. 


Controlling the VSAM File 


Use the SWLD command (page 9-44) to switch the vsaM file associated with the task 
AAUTSKLP to the primary file or to a secondary file. 
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Chapter 9. Session Monitor Command Descriptions 


This section describes the formats and operands of the NetView commands and 
CLISTs that apply to the session monitor (NLDM). The commands can be entered 
from any component. 


The commands are listed in alphabetical order for easy reference. Each command 
description includes the format and description of operands and, where applicable, 
usage notes, responses, and examples. 


The syntax and notation conventions used for the commands and CLISTs are as 
follows: 


e items shown in braces { } represent alternatives. You must choose one. 


For example, 
A 
B or {A|B|C} 
C 


indicates that you must specify one item only: A, B, or C. 


e items shown in brackets [ ] are optional. You may choose one. 


For example, 
A 
B or [A|B[C] 
C 


indicates that you may enter A, B, or C, or you may omit the operand. 


e A series of three periods (...) indicates that a variable number of items may be 
included in the list. 


e An underscored item shows the alternative, or default, the system will choose 
if you do not specify an item. 


For example, 


A 
B 


C 
If no operand is specified, B is assumed. 


e Lowercase italicized items are variable; substitute your own value for them. 
Uppercase items must be entered exactly as shown. 


e Parentheses must be entered as shown. 


e Where keywords can be abbreviated, the abbreviations are shown in capital 
letters. 


For example, 
All 


can be entered as A or ALL. 
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e Where brackets ([ ]) are nested, you must include commas to denote the 
absence of the required positional operands. For example, 


Act A 
[.B 
[,C]] 


To specify c only, enter ACT A,,C. 


For online help on the session monitor (NLDM) commands, enter: 
HELP NLDM COMMANDS 


For help on a specific command, enter: 
HELP command 
where command is the name of the command. 


Note: HELP command is not allowed if NetView is installed with the DASD Conserva- 
tion Option. 
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AUTOCOLL 


The AUTOCOLL CLIST controls the collection of response time monitor (RTM) data. 


The format of the AUTOCOLL CLIST is: 


AUTOCOLL [time] 


where: 

time is the interval, specified as minutes or hours:minutes, for session 
monitor collection of RTM data. The default is 20 minutes. 

Usage Note 


The AUTOCOLL CLIST corresponds to the following command: EVERY time, 
PPT,ID=NLDMC,NLDM COLLECT RTM * NOLOG. See page 3-71 for a description of the 
EVERY command and page 9-7 for the related COLLECT command. 

Example 


To collect RT™ data every 15 minutes, enter: 
AUTOCOLL 15 
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AUTORECD 


The AUTORECD CLIST controls the collection of accounting and resource statistics 
data to the external log. 


The format of the AUTORECD CLIST is: 


where: 

time is the interval, specified as minutes or hours:minutes, for session 
monitor collection of accounting and resource statistics data. The 
default is 20 minutes. 

Usage Note 


The AUTORECD CLIST corresponds to the following command: EVERY time, 
PPT,ID=NLDMR, NLDM RECORD SESSTATS * *. See “EVERY” on page 3-71 fora 
description of the EVERY command, and “RECORD” on page 9-30 for the related 
RECORD command. 


Example 


To record accounting and resource statistics data to the external log every 15 
minutes, enter: 


AUTORECD 15 
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BACK 


The BACK command displays a previous page of a multipage display. 


The format of the BACK command is: 


where: 

n specifies the number of pages to go back. The default is 1. 

Usage Note 

The PF7 is set to the BACK command. If the value of n is greater than the number of 
previous pages, the first page is displayed. If the current page is the first page and 
the BACK command is entered, you will remain on the first page. 


Example 


To look at a page that is three pages back, enter: 
B 3 
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BOTTOM 


The BOTTOM command displays the last page of a multipage display. 


The format of the BOTTOM Command is: 


Usage Note 
PF5 is set to the BOTTOM command. 


When over 999 screens are to be displayed, entering BOTTOM takes you to the last 
page, but the page number on that screen will only go as high as ‘999’. 


Example 


To get to the last page of a multipage display, enter: 


BOTTOM 
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COLLECT 


The COLLECT command gathers response time data from Pus with the RTM feature. 


The format of the COLLECT command ts: 


COLLECT RTM {resname|*} 
[LOG|NOLOG] 


where: 
RTM collects response time data as measured by the RTM feature of a 3174. 
resname_ is the name of a link, PU, or terminal LU. 


collects data for all LU terminals in a domain attached to a 3174 with the 
RTM feature. 


LOG writes collected data to the external log. 


NOLOG_ does not write collected data to the external log. This is the default. 
Usage Note 


Every COLLECT command resets the affected LU counters to zero. Data from COLLECT 
commands that do not have the LOG option is accumulated and will be logged when 
a COLLECT with LOG is issued or when the session ends. 


If you enter this command from a NetView component other than the session 
monitor, prefix the command with NLDM. 


Session start and end times, and data collection times, are stored on the VSAM data 
base with times that are local to the owner of that data base. For example, 
suppose the host that owns the primary end point of a session resides in time zone 
1 and the host that owns the secondary end point resides in time zone 2. At the 
session end, the session is logged by the host of the primary end point with its 
local times (in time zone 1) and logged by the host of the secondary end point with 
its local times (in time zone 2). If the session lasted from 9:00 to 10:00 in time zone 
1 and time zone 2 is 3 hours earlier than time zone 1, the session would be logged 
in time zone 2 as lasting from 6:00 to 7:00. 


When an operator in time zone 1 views this session on the Session History panel, 
the times appear as 9:00 to 10:00. Suppose the secondary end point is a terminal 
attached to a 3174 controller equipped with the RTm feature. When the operator in 
time zone 1 views the panel NLDM.STIME for this session, the times are listed as 6:00 
to 7:00, because the information was retrieved from the host residing in time zone 
2. 


Example 


To collect RTM data from all terminals connected to the 3174 whose Pu is named 
LCL3174A, enter: 


COLLECT RIM LCL3174A 
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COPY 


The copy command sends a copy of the current display to the network log or toa 
hard copy terminal if one is connected. 


The format of the copy command is: 


Usage Note 


Messages are displayed at the operator’s terminal to indicate success or failure of 
the Copy operation. 


Example 


To make a copy of the screen you are displaying, enter: 
COPY 


A copy of the screen will be recorded on the network log or printed on the hard 
copy log if one is connected. | 
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DISABLE 


The DISABLE command stops the collection of session awareness data by VTAM and 
the session monitor. 


The format of the DISABLE command is: 


DISABLE 


Usage Note 


If the DISABLE command is issued: 


e Tracing cannot be started because session awareness data is not being col- 
lected. 


e The DISABLE Command does not disable session awareness if a trace is active 
for any resource. 


e The DISABLE command does not disable session awareness if the network 
accounting and availability function is initialized. 


e After a DISABLE Command is entered, NLDM (AAUTSKLP) must be recycled by 
using the STOPCNM (page 3-165) and STARTCNM (page 3-158) CLISTS in order to 
restart session awareness data collection. 


Example 


To stop collecting session awareness data, enter: 
NLDM DISABLE 
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DISKEEP 


The DISKEEP command displays the number of Pius kept per session. 


The format of the DISKEEP command is: 


where: 


PIUS displays the PiU keep count per session. The keep count is the 
number of Pius which are retained. 


resname1 resource name to apply keep count against (LU, PU, or SSCP name). 
resname2 second name (optional) to identify a specific session. 


ALL apply keep count against all sessions with resname7. ALL is the 
default. 


Usage Note 
This command causes panel Display Keep to display the current settings. 
Example 


To display the Piv count for all sessions with an LU named LCL3278A, enter: 


DISKEEP PIUS LCL3278A 
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ENABLE 


The ENABLE command begins collection of session awareness data. 


The format of the ENABLE command is: 
ENABLE ~ 
Usage Note 
The command allows the session monitor to become aware of any currently active 


sessions and for any sessions activated after the command is issued (see “Session 
Monitor Warm Start” on page 7-5). 
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END 


The END command stops the session monitor panel sequence and returns to the 
component from which the session monitor was invoked. 


The format of the END command is: 


Usage Note 
PF2 is set to the END command. 


Example 


To return to the component from which you invoked the session monitor, enter: 


END 
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FORCE 


The FORCE command causes session data to be recorded in a VSAM file. 


The format of the FORCE command is: 
FORCE resname7 [NET netid1] [resname2 [NET netid2]] 


where: 
resnamel the resource name to force session data to the VSAM data base. 


NET netid1 The name of the network in which the first resource resides. If this 
operand is not specified, then the specified resource is assumed to 
reside in the network of the domain (NetView) in which the force 
command is executed. 


resname2 __‘ the second name (optional) to identify a specific name pair. 


NET netid2 The name of the network in which the second resource resides. If 
this operand is not specified, then the specified resource is assumed 
to reside in the network of the domain (NetView) in which the force 
command is executed. 


Usage Note 


You should request the most recent trace data from VTAM before you enter the 
FORCE command. First display the session trace data selected from the session 
configuration panel and then issue the FORCE command. 


If a session being forced is cross-domain or cross-network, the session must be 
forced by a separate command in each domain to preserve the data integrity of the 
forced session. 


You can issue the FORCE command naming only one resource. If you do this, data 
for all sessions with the named resource are forced to the VSAM data base. 


If you name a SLU, you cause session data to be recorded for the SSCP-LU session 
and all LU-LU sessions the SLU is involved in. 


If you name a PLU, you will force data for all the sessions involving that PLU. If, for 
example, you issued FORCE CICS, you might force data to the data base for hundreds 
of sessions. For this reason, it is better to name only SLUs in the FORCE command if 
only one resource name is used. \ 


When a session ends, the session monitor automatically saves the session trace 
data for that session. In addition, at any time, you can save session trace data by 
using the FORCE command. 


The FORCE command can be helpful with a hung terminal, where the session can 
not be terminated. Here the session monitor will never automatically save the 
trace data. By using FORCE, you can save the session trace data so the technical 
support people can perform problem determination. 
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The FORCE command forces only those sessions that are known to the session 
monitor which executes the command. For example, session monitor in network A 


has no knowledge of a single network session in network B, SO a FORCE on that 
session from network A would not be valid. 


Example 


To record session data for session where resource LCL3278A is in network AO1M and 
resource L51R79M is in network where FORCE command is issued, enter: 


FORCE LCL3278A NET AQ1M L51R79M 


FORWARD 


The FORWARD command displays the next page of a multipage display. 


The format of the FORWARD command its: 
FORWARD [n] 


where: 

n specifies the number of pages to move forward. 1 is the default. 

Usage Note 

The PF8 is set to the FORWARD command. If the value of n is greater than the 
number of remaining pages, the final (bottom) page is displayed. If the current 
page is the final page and the value of nis 1, then page 1 is displayed. 


Example 


To move ahead five pages, enter: 
FORWARD 5 


You will see the fifth page forward from the current page. 
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HELP 
The HELP CLIST provides directions for moving from panel to panel in a multiple- 
page panel, or for moving through the hierarchy of session monitor panels. It pro- 
vides informaiton on how to use the session monitor commands. HELP also 
provides access to the NetView online help facility and to the session monitor glos- 
sary for the current display. 


The format of the HELP CLIST is: 


where: 


cmdname _ specifies the command name. 

Usage Note 

When you enter HELP from a help screen or a command description screen, 
NetView presents the Screen Control/Help Display. When you enter HELP from any 
other screen, NetView presents a help menu for the current display. To get help 
for a specific command, enter HELP cmd, where cmd is the command about which 


you need more information. 


This command is not allowed if NetView is installed with the DASD Conservation 
Option. (See “DASD Conservation Option” on page 2-8.) 


Example 


_ To display the syntax for the DFILTER Command, enter: 
HELP DF 
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KEEP 


The KEEP command changes the amount of Piu data to be kept by session monitor. 


The format of the KEEP command is: 


KEEP = =onnn PIUS _# [FOR] resnamet [resname2|ALL] 
where: 

nnn specifies the number of items to be kept. 
PIUS © specifies a change to the PiU KEEP Count. 


resname1 resource name to apply keep count against. 


resname2 second name to identify a specific session. 


ALL applies keep count against all sessions for resname?7. This is the 
default. 
Usage Note 


To restrict the amount of data retained by the session monitor, you can establish 
KEEP counts in the session monitor. These counts determine how much data will be 
retained. | 


The KEEP PIUS Command restricts the number of Pius kept by the session monitor for 
a specific session. It commands that, for the named resource, the specified 
number (nnn) of messages be kept. Once that number has been reached and a 
new message comes in, that new message is saved and the oldest message is dis- 
carded from the session monitor. The default is 10 Pius, and the maximum is 999. 


When a trace has been started for a resource, the session monitor collects session 
formation parameter data, PiU trace data, and NCP trace data. The Plu trace data 
consists of a portion of each message sent to and from the traced resource. 


Example 


To increase the session keep count to 5 for the terminal L51R79M you would enter: 
KEEP 5 PIUS L51R79M 
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LEFT 


The LEFT command displays session configuration data in the primary direction 
from the Session Configuration Data display. 


The format of the LEFT command is: 


Usage Note 
PF10 is Set to LEFT. 
Example 


To move in the primary direction from the Session Configuration Data display, 
enter: 


LE 
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LINEMAP 


The LINEMAP command displays the network control program (NCP) line port address 
associated with a station attached to an NcP within the same domain. 


The format of the LINEMAP Command is: 
LINEMAP ncpname stationname 


where: 
ncpname specifies the name of the NCP to which the station is attached. 


stationname specifies the name of the Pu for which the address is displayed. 
Usage Note 


For stations where a port address is not applicable, the message returned (AAU0151) 
will specify a port address of N/A. 


You must have NCP v3 or later to be able to use this command. 
Example 


To display ncp line port addresses for PU LCL3174B attached to NCP27, enter: 
LINEMAP NCP27 LCL3174B 
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LIST 


The List command displays a list of resources (network addressable unit names), 
domain names, active explicit routes, or active virtual routes, for which session 
data has been collected. 


The format of the LIST command is: 


where: 
ACTIVE 
HISTORY 
ALL 
LU 


netid 


PLU 

SLU 

PU 
SSCP 
DOMAIN 
ER 


VR 


origpu 


destpu 


* 
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displays active resources only. 

displays history resources only. 

displays all resources. 

displays logical unit names. This is the default. 


the network name for which data is to be listed. The default is the 
local network. 


displays primary logical units for LU-LU sessions only. 
displays secondary logical units for LU-LU sessions only. 
displays physical units only. 

displays SscPs only. 

lists all domains defined to this NetView. 


list active explicit routes as defined by an origin subarea PU name 
and a destination subarea PU name. 


list active virtual routes as defined by an origin subarea PU name and 
a destination subarea PU name. 


the originating subarea PU name of the route to be displayed. 
destination subarea PU name of the route to be displayed. 


lists the origination point or destination point of active Pus. 


Usage Note 


This command displays the panels: 


e Resource Name List 

e Domain List 

e Active Explicit Route List 
¢ Active Virtual Route List. 


These session monitor panels provide lists of resource names, domain names, or 
active explicit and virtual routes known to the session monitor. The resource 
names displayed are determined by the specific List command option you select. 


The Domain List panel lists other domains defined to the local session monitor. 
The table also shows the status of conversations that the local session monitor has 
started with each of these other domains. Information is available only if the two 
session monitors have started the session and have exchanged local-domain infor- 
mation, and if the session is active. If the conversation is shown to be inactive or 
pending activation, the session monitor may display the abbreviation for not appli- 
cable (N/A) in certain fields of the panel. 


Example 


To list active PUs for which session data exists, enter: 
LIST PU 


To list all the active ERS that originate in AO1MPU, enter: 
LIST ER FROM AOIMPU TO * 
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MENU 


The MENU command displays the initial selection options panel which is the first 
panel in the session monitor panel sequence. 


The format of the MENU Command is: 


Usage Note 
This command displays the MENU panel. 
Example 


To display the first panel of the session monitor sequence, enter: 


MENU 
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NCCF 


The NCCF command is used to enter the command facility (NCCF). 


The format of the NCCF command is: 
NCCF [command [operands}] 


where: 


command is acommand facility command. If command is not specified, the 
command facility is invoked. Command facility immediate commands 
are not accepted. 


operands are one or more operands that are passed to the command facility 
along with the command. 


Usage Note 


If you enter NCCF without any operands, you see the command facility screen. Then 
you can enter a command facility command. If you enter a command, you must 
view the resulting messages and return to the original screen (see “RETURN” on 
page 9-32) before entering more commands. 


When a command is sent to the command facility from another component, the 
command is processed by the command facility as if it had been entered directly 
from the command facility. 


When you use this command from another component, the command facility 


remains on the NetView component stack that is used with ROLL until the compo- 
nent is ended. 
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NLDM 


The NLDM command is used to enter the full screen mode of the session monitor, or 
to process a single session monitor command from another NetView component. 


The format of the NLDM command is: 


where: | 

xX indicates that the session monitor is to enter full screen mode, using 
an extended data stream regardless of whether the session monitor 
has detected an extended data stream terminal. If the terminal is not 
an extended data stream terminal, i/o errors will occur. 

N indicates that the session monitor is to enter full screen mode, using 


a non-extended data stream regardless of whether the session 
monitor has detected an extended data stream terminal. 


command is asession monitor line mode command that is to be processed by 
the session monitor, unless previously suspended using the PA2 key. 


Usage Note 


If no operand is specified, the session monitor will determine whether or not to use 
extended data streams by examining the logon mode. 


When you use this command, the session monitor remains on the NetView compo- 
nent stack that is used with ROLL until the session monitor ends. 


The X|N operand is usually entered only the first time you use the NLDM command 
or after you use the NLDM END command. 
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PURGE 


The PURGE command allows the network operator to delete selected data from the 
VSAM data base. 


The format of the PURGE command is: 
PURGE ALL BEFORE {mm/dd/yy hh:mm[:ss]|*} 
ROUTE ‘BEFORE {mm/dd/yy hh:mm{[:ss]|*} 


SESSION resname1 resname2 BEFORE {mm/dd/yy hh:mm[:ss]|*} 


By i BEFORE {mm/dd/yy hh:mm[:ss]|*} 
where: 

ALL deletes all data. 

BEFORE deletes data whose ending time stamp occurs before (or at) the 
specified date and time (mm/dd/yy hh:mm [:ss]) 

ROUTE deletes route data only. 

SESSION deletes session data only. If resource? and resource2 are spec- 
ified, the session monitor deletes data for sessions between 
resource? and resource2. Resource? and resource2 must be 
from 1 to 8 alphanumeric characters and may contain the char- 
acters “*” and “?”. If resname7 and resnamed2 are not speci- 
fied, the session monitor deletes data for all sessions. 

specifies the current date and time when used in place of a spe- 
cific date and time 
represents all resource names when used in place of a specific 
resource name 

Usage Note 


The PURGE command permits the network operator to delete from the vSAm data 
base information which was recorded before (or at) a specific date and time. The 
options available are: all data, route data, or session data. By the use of resource 
names, the purge of session data can be limited to specific sessions. 


The PURGE command is asynchronous; once initiated by operator or CLIST, it runs 
concurrently with the session monitor operator. The operator receives a ‘PURGE 
STARTED’ message when the purge begins. The operator can continue to enter 
more commands. The authorized receiver receives a ‘PURGE COMPLETED’ message 
when the purge completes. The completion message describes the type and count 
of the data purged. 


If multiple PURGE commands are entered, the session monitor responds to each 


command with the ‘PURGE STARTED’ message. However, they will run consecutively. 
The first purge completes before the second purge, and so on. 
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Examples 
PURGE SESSION LCL3278A L51R79M BEFORE 5/26/87 23:59 


This example purges all sessions which have resource name pairs of LCL3278A and 
L51R79M and a session end time before (or at) 23:59 on 5/26/87. 


PURGE ROUTE BEFORE * 


This example purges all route data with an end time before (or at) the current 
system date/time. 


PURGE ALL BEFORE * 


This example purges all session data and all route data before (or at) the current 
system date/time. 


PURGE SESSION A?C* * BEFORE * 
This example purges all sessions which have resource name pairs matching the 


patterns ‘A?C”’, ‘*’ and a session end time before (or at) the current system 
date/time. 
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PURGEDB 


The PURGEDB Command purges hardware monitor and session monitor data. 


The format of the PURGEDB command is: 


PURGEDB [ROUTE|RT] BEFORE date [time] 
[SESSION|SESS] resname?l resname2 BEFORE date [time] 
RT/SESS BEFORE date [time] 
[EVENT|EV] [ATTACHED|ATT]{resname|*ALL|addr} BEFORE date 
[STAT|ST] [ATTACHED|ATT}{resname|*ALL} BEFORE date 
EV/ST [ATTACHED|ATT] {resname|*ALL} BEFORE date 

where: 

ROUTE|RT specifies session monitor ROUTE data. 


SESSION|SESS _ specifies session monitor SESSION data. 


RT/SESS specifies session monitor ROUTE and SESSION data. 

EVENT|EV specifies hardware monitor EVENT data. 

STAT|ST specifies hardware monitor STAT data. 

EV/ST specifies hardware monitor EVENT and STAT data. 

resnamei|resname2 specifies the name of the resource for which purging is to be 
done. 

ATTACHED specifies if resource is attached. 

*ALL deletes data for all resources. 

addr specifies a 12 hexadecimal digit address. 

date acceptable formats for date are: 


¢ MM/DD/YY - leading zeros are not required 

¢ MMDDYY - leading zeros are required 

e -NNN - number (from 0-365) 

e *-current date (and current time unless time also speci- 
fied). 


time acceptable formats for time are: 


e HH:MM:SS - Leading zeros are not required 
e HH:MM - leading zeros are not required 
e *-current time. 


Example 


To purge session monitor data, enter: 
PURGEDB RT/SESS BEFORE -5 16:25 
Ail sessions which have a session start time of five days prior to the current 


system date and a time of 16:25:00, and all routes which have an end time of the 
same, are purged. 
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QUERY PF 


The QUERY PF command displays the current session monitor PF key settings. 


The format of the QUERY PF command is: 


Example 


To display the setting for the session monitor PF keys enter: 
Q PF 


9-28 NetView Operation 


QUERY RANGE 


The QUERY RANGE command displays the active time range from either the last SET 
RANGE command or the default time range. 


The format of the QUERY RANGE Command is: 


‘Query RANGE 


Example 


To display the time range you set on your last SET RANGE Command, enter: 
Q RANGE 
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RECORD 


The RECORD command writes the accounting and resource statistics data, or 
storage and cpu utilization data, to the external log. 


The format of the RECORD command is: 


where: 

SESSTATS writes accounting and resource statistics for name1 and name2 
to the external log. 

name specifies the resource name of the primary session partner. 

name2 specifies the resource name of the secondary session partner. 

STRGDATA writes session monitor storage data statistics to the external 
log. 

Usage Note 


You can use specific resource names for resname7 and resnamed2, or you can use 
one of the following forms: 


: represents all resource names. 

abc* represents all resource names beginning with abc. 

ab?????c represents all eight character resource names, beginning with 
ab and ending with c. 

Example 


To write accounting and resource statistics for all sessions, enter: 
RECORD SESSTATS * * 


To write accounting and resource statistics for all sessions between resources 
beginning with TSO and LU, enter: 


RECORD SESSTATS TSO* LU* 


To write accounting and resource statistics for all sessions between resources with 
eight character names, beginning with a T and ending with 1, and all resources 
beginning with Lu2, enter: 


To write session monitor storage and cPu utilization data, enter: 
RECORD STRGDATA 
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RELOAD 


The RELOAD command reloads the RTM PCLASS and MAPSESS or the KCLASS and 
MAPSESS definition statements. 


The format of the RELOAD command is: 


RELOAD {PERFMEM|KEEPMEM} 
[FROM] membername _ 


where: 
. PERFMEM reloads RT performance class definitions. 
KEEPMEM reloads KEEP CLASS definitions. 


membername_ specifies the name of a member in DSIPARM (data set for MVS or a 
filename with the filetype NCCFLIST for vm) from which definitions 
are reloaded. 


Example 


To reload the RTM performance class definitions from member RTMCLASS of DSIPARM, 
enter: 


RFIOAN PFRFMFM RTMCI ASS 
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RETURN 


The RETURN command is used to go back to a previous panel, or return to the menu. 


The format of the RETURN Command is: 


Usage Note 

If this command is issued following a session monitor command such as RTREND, 
the menu panel is displayed. Otherwise, the panel that was displayed before the 
current panel is displayed. 


PF3 is set to the RETURN command. 
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RIGHT 


The RIGHT command displays session configuration data in the secondary direction 
from the Session Configuration Data display. 


The format of the RIGHT command is: 


Usage Note 
PFi1 is set to the RIGHT command. 
Example 


To move in the secondary direction from the Session Configuration Data display, 
enter: 


RI 
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RTREND 


The RTREND command displays the response-time trend over a specified range of 
time for a terminal LU connected to a cluster controller that supports the RTM 
feature. 


The format of the RTREND command is: 


where: 


luname _ specifies the name of the terminal for which response time is measured. 


Ss specifies the maximum response time, in seconds, to be used for the 
graph. The format is ssss.s; the maximum value allowed is 1800 
seconds. 

OBJ specifies the response time objective set for this Lu. This is the default. 

datel specifies the starting date of the time range. | 

timet specifies the starting time of the time range. 

date2 specifies the ending date of the time range. 

time2 specifies the ending time of the time range. 


uses the default time and date for the command. For ending date and 
time, the default is the current date and time. For starting date and 
time, the default is 2 hours before the ending date and time. 


Usage Note 
This command displays the Response Time Trend panel. 


Dates are in the format mm/dd/yy and times are in the format hh:mm. lf time is 
specified but date is omitted, the current date will be used. If all date and time 
operands are omitted, they default to the time range set by the most recent SET 
RANGE command. If no SET RANGE command has been issued the defaults are 
current time for fime2 and 2 hours earlier for time7. If you issue a command that 
has an end time past the last command issued you will get the latest time. 


If the LU is in another domain, you must first use the SDOMAIN command to specify 
the domain that contains the Lu. 


9-34 NetView Operation 


Example 


Given the following conditions: 


e You are collecting data every 30 minutes on the quarter hour (07:45, 08:15, 
08:45, and so on) and a user with terminal luname LU3270A logged on at 08:43 
(March 14, 1987). 


e The user is still logged on and the time is now 14:17. 


e The user’s session was mapped into a performance class with counter bounda- 
ries of .5, 2, 5, and 10 seconds, and an objective that 80% of the transactions 
should take less than 5 seconds. 


The command: 
RTREND LU3270A 9:00 * 


produces a panel of two pages (since there are more bars than can be shown on 
one page) with percentages of transactions under 5 seconds from 09:00 to 14:17. 


The command: 
RTREND LU3270A OBJ * 15:00 


produces a one-page panel with four bars representing the percentage of trans- 
actions under 5 seconds from 12:45 to 14:17. 


The command: 


RIREND LU3Z/0A i.5 FROM 3/14/87 08:60 


produces a one-page panel showing the percentage of transactions under 2 
seconds from 08:43 to 13:45. 


Chapter 9. Session Monitor Command Descriptions 9-35 


RTSUM 


The RTSUM Command displays the response time summary for the named Lu that is 
connected to a cluster controller that supports the RTM feature. 


The format of the RTSUM command is: 


where: 


luname _ specifies the name of the terminal for which response time is measured. 
date specifies the starting date of the time range. 

time specifies the starting time of the time range. 

date 2 specifies the ending date of the time range. 

time2 specifies the ending time of the time range. 


* 


uses the default time and date for the command. For ending date and 
time, the default is the current date and time. For starting date and 
time, the default is 1 hour before the ending date and time. 


Usage Note 
This command displays the Response Time Summary panel. 


Dates are in the format mm/dd/yy and times are in the format hh:mm. If time is 
specified but date is omitted, the current date will be used. If date and time are 
omitted, they default to the time range set by the most recent SET RANGE command. 
If no SET RANGE Command has been issued the defaults are the current time for 
time2 and 1 hour earlier for time7. If you issue a command that has an end time 
past the last command issued you will get the latest time. 


If the LU is in another domain, you must first use the SDOMAIN command to specify 
the domain that contains the Lu. 


Example 


Given the following conditions: 


e You are collecting data every 30 minutes on the quarter hour (07:45, 08:15, 
08:45, and so on) and a user with terminal LU name LU3270B logged on at 08:12 
(March 15, 1987). 


e The user is still logged on and the time is now 13:24. 
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The command: 

RTSUM LU3270B 8:00 * 

produces a panel showing a summary of his response times between 08:12 to 
13:24. 

The command: 

RTSUM LU3270B FROM 3/15/87 8:00 TO 3/15/87 13:30 


produces the same panel as the one above. 


The command: 

RTSUM LU3270B 9:00 10:00 

produces a panel showing a summary of the user’s response times between 08:45 
and 10:15. 

The command: 

RTSUM LU3270B * * 


produces a panel showing a summary of the user’s response times between 12:15 
and 13:24. 7 
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SDOMAIN 


The SDOMAIN command specifies the domain from which session data is to be dis- 
played. 


The format of the SDOMAIN Command is: 


where: 

domainid specifies the name of the desired domain. 

Usage Note 

Before using the SDOMAIN Command, a session must exist between the hosts in the 
two domains. Operators can be allowed or prohibited access to the specified 
domain by using the appropriate initialization statements for that domain. For 
more information, see NetView Administration Reference. 


Example 


To specify that session data is to be displayed from DOM3, enter: 
SDOMAIN DOM3 
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SENSE 


The SENSE command displays the explanation of a specific SNA sense code. SENSE 


codes are summarized as space on the screen permits. 


The format of the SENSE command is: 


SENSE code 


where: 


code __is the sense code in hexadecimal. 
Usage Note 


This command displays the Sense Code Description panel. 


SENSE codes may be summarized as space on the screen permits. 


Example 


To get a description of sense code X‘0806’, enter: 
SENSE 0806 


Response 


You will see information similar to the following: 
SENSE DATA: 


CATEGORY - (08) RESOURCE UNKNOWN: THE REQUEST CONTAINED A NAME OR 


MODIFIER - (06) ADDRESS NOT IDENTIFYING A PU, LU, LINK, OR LINK STATION 


BYTE 2 - (00) KNOWN TO THE RECEIVER. 
BYTE 3 - (00) 
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SESS 


The SEss command displays the session list for a specific resource or all sessions 
between two specific resources. 


The format of the SESS command is: 


where: 

resnamel select only those sessions in which one of the session partners is 
indicated by resname7. resname7 must be 1 to 8 alphanumeric 
characters. 

resname2 select only those sessions between resname?7 and resname2. 


resname2 must be 1 to 8 alphanumeric characters. 


WITH PCID Display the fully-qualified PcID associated with each session. If 
WITH PCID is not specified, do not display the fully qualified Pcips. 


“DISCARD select the *DISCARD pseudo session (the session to which all dis- 
carded PIUS are associated). 


Usage Note 

This command displays the Session History panel. 
For more information on “DISCARD, see page 7-3. 
Example 


To display the session list that the LU L51R79M has been and currently is included in, 
enter: 


SESS L51R79M 


To display a list of active and inactive sessions between two specific resources, 
LCL3278A and L51R79M, along with their PciDs, enter: 


SESS LCL3278A L51R79M WITH PCID 
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SET HEX 


The SET HEX command sets hexadecimal display mode. 


The format of the SET HEX command is: 


where: 
ON specifies that hexadecimal mode is to be turned on. 


OFF specifies that hexadecimal mode is to be turned off. 
Usage Note 


When hexadecimal mode is on, the trace data and the Session Activation Parame- 
ters are displayed in hexadecimal. When hexadecimal mode is off, the trace data 
and the Session Activation Parameters are displayed as text. 


If neither ON or OFF is specified, the SET HEX Command reverses the current setting. 


This command affects the following panels only: 


e pil Trace Data 
e NcP Session Trace Data 
e Session Parameters. 


The hexadecimal mode setting remains in effect until you leave the session 


monitor with the END command. Hexadecimal mode will be turned off the next time 
you enter the session monitor. 
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SET PF 


The SET PF command defines a PF Key function. 


The format of the SET PF command is: 


where: 

PFnn specifies the PF key (1 - 24) being defined. 

IMMED indicates the command is processed immediately when the PF 
key is pressed. 

DELAY indicates that the command is written into the input area of the 
terminal and the cursor positioned after the last character. The 
command is processed by the session monitor when the ENTER 
key is pressed. This is the default. 

APPEND indicates that data in the input area is added to the end of the 
command when the PF key is pressed. 

IGNORE indicates the data in the input area is ignored. This is the 


default. 


command text specifies the command is to be executed when the PF key is 
pressed. 


Usage Note 


This command when entered in the session monitor only affects the session 
monitor PF keys. 


The PF key settings remain in effect until you leave the session monitor with the 
END command. The PF keys will be returned to their default settings the next time 
you enter the session monitor. | 


Example 


To set PF 4 to execute the SET HEX command immediately, and have it append data 
such as ON or OFF from the command input line, enter: 


SET PF4 IMMED APPEND SET HEX 
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SET RANGE 


The SET RANGE command sets the time range that is used for all session monitor 
commands that display data by time. 


The format of the SET RANGE command is: 


SET RANGE [FROM] {[date7] time? |*} [To] {[date2] time2 | *} 


where: 

date specifies the starting date of the time range. 

time specifies the starting time of the time range. 

date2 specifies the ending date of the time range. 

time2 specifies the ending time of the time range. 

: uses the default time and date for the date display command being 
issued. 

Usage Note 


Dates are in the form mm/dd/yy and times are in the form hh:mm using the 24-hour 
clock. If the time is specified but the date is omitted, the date defaults to the 
current date. 


The time range setting remains in effect until you leave the session monitor with 
the END command. The time range returns to its default setting the next time you 
enter the session monitor. Refer to the NetView Installation and Administration 

Guide for a description of the default setting. 


Example 


To set a default range of 8:00 Am to 5:00 pm, enter: 
SET RANGE FROM 08:00 TO 17:00 
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SWLD 


The SWLD CLIST switches the files used by the session monitor to store data ona 
vsan file. 


The format of the SWLD command is: 


where: 

P specifies to use the primary VSAM file. 

S specifies to use the secondary VSAM file. 

Usage Note 

Session data is logged to VSAM by the session monitor at various times during a 
session. Switching the session monitor data base between the primary and sec- 
ondary VSAM files could cause a session's data to become divided between the two 
VSAM files. Division of a session’s data may give unpredictable results when trying 
to display data which is not on the active vsam file. 


Example 


If you are encountering errors on the primary file, you can change to the secondary 
file by using the following command: 


SWLD $ 
Response 


You will see a message similar to: 
DS15471 AAUTSKLP: SECONDARY VSAM DATA SET IS NOW ACTIVE 
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TOP 


The ToP command displays the first page of a multipage display. 


The format of the TOP command is: 


Usage Note 

If you enter this command for a single-page display, no change occurs. 
PF4 is set to the TOP command. 

Example 


To display the first page, enter: 
TOP 
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TRACE 


The TRACE command starts or stops a session trace or displays resources that are 
being traced. 


The format of the TRACE command is: 


where 

START starts trace functions for specified resources. 

STOP stops trace functions for specified resources. 

resname specifies any valid network name (such as LU, PU, or 
SSCP name). 

NET netid specifies the name of the network in which the specified 
resource resides. If the netid is not specified, the 
operator’s local netid is used. 

ALL performs tracing for all network resources. 

DOMAIN domain specifies the domain in which the TRACE command is 
executed. 

DISP displays all traces that have been activated or deacti- 
vated explicitly. 

Usage Note 


If collecting trace data has not been automated by the system programmer, you 
might be instructed to start data collection for some resources. The TRACE START 
command starts a session trace. It will start collecting session formation parame- 
ters, Plu trace data, and NCP trace data. 


It is possible for the system programmer to start gathering trace data following 
session monitor initialization, and start tracing all resources. If this is done, you 
might be instructed to stop data collection for some resources. 


You can learn which devices are being traced by using the TRACE DiSsP Command, 
which invokes panel Display Trace. The TRACE DISP command displays a list of 


resource names. Interpretation of that list depends on how tracing was started. 


If TRACE is started for all resources then the Global Trace field will indicate ON and 
any resources that are displayed will have had trace stopped. 


If TRACE is stopped for all resources then the G/obal Trace field will indicate OFF 
and any resources that are being traced will be displayed. 


You can issue the TRACE command as a line-mode command. In this case, the 
TRACE command must be preceded with NLDM. 
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Both vTAM and NCP are notified when an operator issues the trace explicit 
command. If the trace to VTAM is successful but the trace to NCP is rejected, the 
trace display will indicate that the resource is being traced, but it will have incom- 
plete trace data. 


Example 


If tracing has been started for specific resources, enter: 
TRACE DISP 


to display a list of network names that are being traced. 


To start tracing a specific Lu, for instance LCL3278A, which is in network Ao1M, enter: 
TRACE START LCL3278A NET AO1M 
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Part 4. Status Monitor 


NetView Operation 


Chapter 10. Getting Acquainted with the Status Monitor 


Terminology 


The status monitor collects and summarizes information on the status of resources 
defined in a VTAM domain. You can use this information to control these resources. 
The status monitor can automatically restart failing network resources and monitor 
important NetView messages. You can also use it to browse the network log. 


The status monitor groups VTAM resources into major and minor nodes. 
Figure 10-1 shows an example of the hierarchy that the status monitor uses. 


- NCP/CA SWITCHED 


“Majors. Major. — Major hej 
oe Nodes Nodes 


_ Nodes Nodes 


ae es i 2 = rs ee oe _ 


Figure 10-1. Status Monitor Hierarchy 


The term higher node refers to the next node up in the hierarchy. For example, in 
Figure 10-1, the switched major nodes are the next higher node in relation to the 
switched PU minor nodes. The term lower node refers to the next node down in the 
hierarchy. Domain represents the highest level in the status monitor hierarchy. 
Resources of the same type are considered to be at the same level. For example, 
all Pus are on the same level in the hierarchy. 
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Color or Intensity Usage 


The status monitor uses the following colors (on color terminals) or high-low inten- 
sity (on monochrome terminals) as follows: 


e Green (normal intensity) — normal condition 

e Pink (normal intensity) — pending condition 

¢ Turquoise (normal intensity) — normal condition 
¢ Yellow (normal intensity) — caution condition 


e Red (high intensity) — problem condition. 


Resource States 


The status monitor displays information about different resource states. These 
states can be any of the following: 


ACTIVE nodes that are active (shown in green or normal intensity). 

PENDING nodes that are waiting to become active or inactive (shown in pink 
or normal intensity). 

INACT nodes that have been inactivated (shown in red or high intensity). 

MONIT nodes that are inactive, but that status monitor is automatically 


trying to make active (shown in yellow or normal intensity). 


NEVACT nodes that have never been in an active state (shown in turquoise 
or normal intensity). 


OTHER all other possible states (shown in turquoise or normal intensity). 


Monitoring Inactive Nodes 


The status monitor can reactivate minor nodes (other than applications (APPLS) and 
cross domain resources (CDRSCS)) that are in the VTAM inactive state. This is known 
as the monitoring function. 


When the NetView program is started, every node that is not active but has a 
desired state of active, will be monitored after typing in MONON and making sure 
0 MONIT iS Coded in DSICNM. 


While NetView is running, non-switched Pus, lines, or NCPS may fail, causing VTAM 
to issue an unsolicited “IST1051 nodename NODE NOW INACTIVE” message. Status 
monitor intercepts this message. If a node that has failed can be monitored and its 
higher node is active, pending, or being monitored, status monitor will monitor the 
failed node for reactivation. On the status monitor screens, these nodes are dis- 
played under the MONIT heading. Inactive nodes that are not monitored are dis- 
played under the INACT heading. 


Status monitor attempts to activate monitored nodes once every minute. When the 
node leaves the inactive state, its lower level nodes will be monitored. 


At installation time the system programmer can modify VTAMLST files to disable 
monitoring for individual resources. 
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While status monitor is running, automatic reactivation can be controlled using the 
MONIT command. Using the ALL parameter, the entire monitoring function may be 
turned off or on by the operator. The MONIT command will also allow monitoring to 
be stopped and later restarted for individual resources. 


Using the Status Monitor 


To use the status monitor, enter the command: 
STATMON 


The next panel displayed is the Domain Status Summary panel: 
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Figure 10-2. Domain Status Summary Panel 


The Domain Status Summary panel summarizes the status for all the resource 
types in the hierarchy within the domain. The status monitor uses two types of 
panels: 


Summary Provides information on the status for all resource types under any 
node. 


Detail Provides a list of nodes (by name) one level immediately below the 
node for which the detail panel was selected. 


Panel Layout 


Each panel is divided into the following sections: 


e General Information — Section 
¢ Command Interface Area — Section. 
¢ Detailed Information Area — Section 
e Command Entry Area — Section ©. 
e PF Key Area — Section : 
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Figure 10-3. Status Monitor Panel Layout 


Refer to Figure 10-3 as you read about each section. 


General Information | 
Section ©® gives general information about the panel that is displayed. Information 
such as the panel name, date and time that the panel was last updated, and infor- 
mation on the resources that are listed is given. Also, if appropriate, the name of 
the domain (host) and the higher level node in the hierarchy are listed. 


Command Interface Area 
Section <.° (found only on the detail displays) contains commands that you can 
select to control and monitor the resources that are listed. You can select the com- 
mands by using the cursor or light pen. You can use PF10, PF11, PF12, or a corre- 
sponding command to access the Command Interface Area which will contain one 
of the following: 


¢ vVTAM commands let you display, activate, or deactivate specified resources 
e CLIsTs let you perform additional functions on the specified resources 


® MENU display lets you control panel formats, the data to be displayed, and 
move up and down the hierarchy. 


e Selection of the ‘total’ counter is equivalent to the selection of every resource 
name shown on the panel. 


Detailed Information Area 
Section ‘<. (found only on detail panels) lists information about the resources that 
are displayed. 
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Command Entry Area 
Section 2% allows you to enter NetView (browse facility, command facility, hard- 
ware monitor, session monitor, or status monitor) commands. You can also enter 
VTAM commands. Enter commands to the right of cuD = = > (the command line). 


PF Key Area 


Section < lists the pF keys that can be used on this display. 


Selecting Fields Using a Light Pen 
To select a command (for example VARY ACT), press the tip of the light pen at any 
character in the VARY ACT field. 


Once you have selected the field with the light pen, the space (sometimes a ques- 
tion mark) that precedes the field will be changed to a less-than symbol (<). On 
detail panels, you would then select the resource or resources that are associated 
with the command. When you are ready to send the command to the system, press 
ENTER. The system processes the command. Some commands will return the 
information in line mode. If this happens, press ENTER when the asterisks (***) are 
displayed in the lower left corner of the screen. Not all the commands result ina 
line mode display. Depending on the command, a status monitor panel may be 
displayed. 


Selecting Fields Using the Keyboard 
To select a command (for example VARY ACT), use the tab key to place the cursor 
next to the field you want to select. Type any character over the question mark (7), 
except another question mark or a blank. Repeat this for each field you want to 
select. When you are ready to send the command to the system, press ENTER. The 
system processes the command and displays the results on a line mode screen 
(for example MONON). When some commands are entered from the status monitor, 
a NCCF screen is displayed in full-screen mode without asterisks (***) in the lower 
left corner. Then you must enter return or roll back to status monitor, not just 
press ENTER. When some commands are entered from status monitor, a NCCF 
screen is displayed with asterisks (***) in the lower left corner (for example DISPFk). 
Then you will return to status monitor by just pressing ENTER. Not all the com- 
mands result in a line mode display. Some commands resulting in a status 
monitor panel may be displayed. 


Moving through the Hierarchy 


The status monitor presents information in a sequence of panels. Figure 10-4 on 
page 10-6 shows the sequence of panels through which you can move. Certain 
commands (listed in the left column of the figure) can be used to go to a panel 
directly, without going through the hierarchy. For example, you can use the 
STATMON nodename command to go directly to the Node Status Detail panel. You 
can then move up or down in the hierarchy of panels by using the prompts shown 
with each display. 


When you select panels by going through the hierarchy, use PF3 to go back to the 
Domain Status Summary panel or to the command facility. 
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Figure 10-4. Status Monitor Panel Hierarchy 


The panels in Figure 10-4 can be used as follows: 


Domain Status Summary | 
This panel shows you every type of major and minor node within your 
domain. It gives you a total node count for each resource type and, 
for each resource type, shows you the number of resources that fall 
into each VTAM activation state. 


Domain Status Detail 
By selecting any total displayed in the Domain Status Summary, you 
can display the Domain Status Detail for that resource type. For 
example, if you selected LINES, the Domain Status Detail would 
display all of the lines for the domain identified in the header section. 


Initially, the Domain Status Detail display is presented in description 
format. In this format each node is listed followed by a description of 
the node. By pressing PF12 (MENU), you can select the analysis or 
activity format of the domain status detail display. The analysis 
format summarizes the status of each displayed node, over a period 
of time. The activity format, available only for application programs 
and application program major nodes, summarizes the message 
traffic to and from the listed application programs or terminal Lus. 


Node Status Summary 
This panel is similar in format to the Domain Status Summary, but it 
is for a selected node rather than for the entire domain. The rows in 
this panel list vTAM node levels lower than the selected level, and the 
columns list the activation states: active, pending, inactive, moni- 
tored, never active, and other. This panel is filled in with the count of 
each node and its status as indicated by the column heading. 


Node Status Detail 
This panel is similar in format to the Domain Status Detail. The 
resources shown in this panel are the minor nodes included in the 
selected major node from the Domain Status Detail panel. 
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Network Log 


Initially, the Node Status Detail display presents each node, followed 
by a description of the node. By pressing PF12 (MENU), you can select 
the analysis or activity format of the node status detail display. The 
analysis format summarizes the status of each displayed node, over a 
period of time. The activity format, available only for application pro- 
grams and application major nodes, summarizes the message traffic 
to and from the listed application programs or terminal Lus. 


By selecting one of the message indicators at the top of a status 
monitor panel or by pressing PF4, you can look at messages that are 
written to the active network log. Depending on the indicator you 
selected, the messages will be highlighted in different colors. You 
can also look at the network log by entering BROWSE NETLOGX where ‘x’ 
is either ‘a’ for the active log, ‘i’ for the inactive log, ‘p’ for the 
primary log or ‘s’ for the secondary log. See “BROWSE” on 

page 3-33 for more information. 


For explanations of the fields shown on the panels, see Appendix B, “List of Panel 
Fields” on page B-1. 


To leave the panel hierarchy and return to NetView, press PF2. 


Program Function Keys 


The status monitor program function keys are as follows: 


PF1 HELP Displays help information. 

PF2 END Returns you to the component that you were using before you 
entered the status monitor. 

PF3 RETURN Returns you to the previous panel in the hierarchy. 

PF4 BROWSE Allows you to browse the active network log (where the mes- 
sages processed by NetView are stored) and look at all the 
messages that have been logged. Note: If you do not have 
an active network log, an error message appears, and you 
need to enter BROWSE NETLOGS Or BROWSE NETLOGP on the 
command line to browse the network log. 

PF6 ROLL Allows you to move among active components in a contin- 
uous loop. ROLL returns you to the last panel you viewed in 
an active component. 

PF7 BACK Returns to the previous page of a multipage panel. 

PF8 FORWARD Goes to the next page in a multipage panel. 

Note: PF7 and PF8 appear on a panel only when there are 
more screens to see. 

PF9 REFRESH Updates the Domain Status Summary panel every minute, or 
within 15 seconds of a VTAM status change. If you press PF9 
again, no automatic update will be made. 

PF10 VIAM Displays a set of VTAM commands. 

PF11 CLIST Displays a set of CLISTs. 
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PF12 MENU Displays commands that you can use to move between 
panels or to control the panel format. The commands are 
placed in the command interface area of the panel. 

Note: PF10, PF11 and PF12 are valid only in detail screens. 


The status monitor PF keys cannot be changed. 


Online Help Information 


To get online help for the status monitor, enter: 
HELP STATMON 


To get online help, enter the HELP command from any status monitor panel. HELP 
STATMON is not allowed if NetView is installed with the DASD Conservation Option. 


10-8 NetView Operation 


Chapter 11. Using Status Monitor Commands 


This chapter illustrates some of the abilities of the status monitor. For specific 
command syntax or for more information, see Chapter 12, “Status Monitor 
Command Descriptions” on page 12-1. You can also receive online help informa- 
tion on the status monitor commands by entering the following command: 


HELP STATMON COMMANDS 


HELP STATMON is not available if NetView has been installed with the DASD Conserva- 
tion Option. 


Getting to the Status Monitor 


To get to the status monitor, use the STATMON Command (page 12-12). 


Automatic Reactivation of Resources 


The status monitor tries to reactivate nodes that have failed and have been made 
inactive by VTAM. You can use the MONIT command (page 12-6) to control this reac- 
tivation of nodes. You can also use the CLISTS MONON (page 12-8) or MONOFF (page 
12-7), to control reactivation. 


Your system programmer can indicate in the vTAMLST file the nodes that cannot be 
reactivated automatically. All these nodes go into a reactivation exclusion list. 
You can add nodes to this list using MONIT STOP Or MONOFF. You can remove nodes 
from this list using MONIT START Or MONON SO long aS NOMONIT was not specified in 
the file VTAMLST for the particular node. 


Browsing the Network Log 


The status monitor allows you to browse the network log. 


You can browse the network log by pressing PF4, or by selecting one of the 
message indicators at the top of a status monitor display. The message indicators 
look like: 


*Q* *4 * =" *3* *A* 


If the message indicator selected is not on (without any highlighting — including 
color or blinking), the last line of the active log will be displayed. If the message 
indicator selected is on (blinking or displayed in reverse video), 18 lines of the log 
will be displayed starting at the message that first set the message indicator on 
and continuing with the messages that were generated after the indicator was set 
on. Messages associated with this indicator will be displayed in the associated 
color. When all messages for a particular indicator have been viewed, that indi- 
cator will no longer be on. 


Generally, when you browse the network log, you browse the active log. However, 


if you select an old message indicator, you may browse the inactive log (NETLOGI). 
If you press PF4 (TOP), the top of the log file appears. 
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Your system programmer defines which messages will be associated with a partic- 
ular indicator (*1*, *2*, and so on) and also defines the colors and highlighting of 
the message indicators. Usually, the message indicators signify levels of severity. 
For example, messages associated with indicator *4* could be more critical 
(severe) than messages associated with indicator *1*. 


For a network log line that contains KANJI data, zero to three consecutive dummy 
characters (periods) may appear at the start and end of the line to correct KANJI 
information that is incomplete. This can happen because of the length of the infor- 
mation or the affect of left and right scrolling. Invalid KANJI characters are replaced 
by double-byte asterisks. 


See Figure 11-1 for an example of the Network Log panel. 


Figure 11-1. Network Log Browse 


In addition to the PF keys used throughout the NetView program, the network log 
browse facility provides the following additional PF key functions: 


PF4 TOP Displays the first line of the browsed network log. 
PF5 BOTTOM Displays the last line of the browsed network log. 
PF7 BACK Moves the screen backward through the information being 


browsed. You can vary the amount that you go back by 
entering one of the following values in the SCROLL field in the 
upper right corner of the panel: 


Half Moves back half a screen. 
MAX Moves back to the beginning of the network log. 
Page Moves back one screen. 


nnnn~ A one- to four-digit number that specifies the 
number of lines to move back. 
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PF8 FORWARD 


PF9 REPEAT (FIND) 


PF10 LEFT 


PF11 RIGHT 


PF12 ALL or ONE 


Moves the screen forward through the network log. You can 
vary the amount that you go forward by entering one of the 
following values in the SCROLL field in the upper right corner 
of the panel: 


Half Moves forward half a screen. 
Max Moves forward to the end of network log. 
Page Moves forward one screen. 


nnnn A one- to four-digit number that specifies the 
number of lines to move forward. 


Causes the previously entered FIND command to be issued 
again. See “FIND” on page 12-4 for information on the FIND 
command. You can also use the REPEAT command (page 
12-11) to issue the previous FIND command. 


Moves the screen left over the network log. You can vary 
the amount that you go left by entering one of the following 
values in the SCROLL field in the upper right corner of the 
panel: 


Half Moves to the left half a screen. 
Max Moves the screen to the left-hand margin of the log. 
Page moves to the left one screen. 


nnnn A one- to four-digit number that specifies the 
number of columns to move left. 


Moves the screen right over the network log. You can vary 
the amount that you go right by entering one of the following 
values in the SCROLL field in the upper right corner of the 
panel: 


Half Moves to the right half a screen. 


Max Moves the screen to the right-hand margin of the 
log. 


Page Moves to the right one screen. 


nnnn- A one- to four-digit number that specifies the 
number of columns to move right. 


Displays all important message indicator types (*1*, *2*, *3%, 
and *4*) in their respective colors (ALL). If you press PF12 
again, only the important message indicators for the type 
you selected last are shown in color (ONE). However, if you 
have never selected an indicator, no message indicators 
are shown in color. The words ALL or ONE are located next 
to the PF key explanation on the bottom of the screen indi- 
cate which mode you are not using. 
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Resetting the Status Analysis Counts 


The status monitor collects node status analysis statistics continuously. These sta- 
tistics are displayed cumulatively. However, you can clear these statistics to set a 


new starting point at any time. To do this, use the CLRSTATS command (page 
12-3). 
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Chapter 12. Status Monitor Command Descriptions 


This section describes the formats and operands of the status monitor commands 
and CLists. The commands can be entered from any component. 


The commands are listed in alphabetical order for easy reference. Each command 
description includes the format and description of operands and, where applicable, 
usage notes, responses, and examples. 


The syntax and notation conventions used for the commands and CLISTs are as 
follows: 


Items shown in braces { } represent alternatives. You must choose one. For 
example, 


A 
B or {A|B|C} 
C 


indicates that you must specify either A, B, or C. 


Items shown in brackets [ ] are optional. You may choose one, or none. For 
example, 


A 
B or  [A[B|C] 
C 


indicates that you may enter A, B, or C, or you may omit the operand. 


A series of three periods (...) indicates that a variable number of items may be 
included in the list. 


An underscored item shows the alternative, or default, the system will choose 
if you do not specify an item. For example, 


A 
B 


C 
If no operand is specified, B is assumed. 


Lowercase italicized items are variable; substitute your own value for them. 
Uppercase items must be entered exactly as shown. 


Parentheses must be entered as shown. 


Where keywords can be abbreviated, the abbreviations are shown in capital 
letters. For example, | 
All 


can be entered as A Or ALL. 


Where brackets ([ ]) are nested, you must include commas to denote the 
absence of the required positional operands. For example, 


Act A 
[,.B 
[,C]] 


To specify c only, enter ACT A,,Cc. 
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For online help on the status monitor commands, enter: 
HELP STATMON COMMANDS 


For help on a specific command, enter: 
HELP command 


where command is the name of the command. The HELP command is not available 
if NetView has been installed with the DASD Conservation Option. 
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CLRSTATS 


The CLRSTATS command resets the node status analysis statistics to zero. You may 


want to do this periodically so that you can better notice when nodes become inac- 
tive. The analysis statistics are cumulative. 


The format of the CLRSTATS command is: 
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FIND 


The FIND command is used while browsing a data set to locate specific information. 


The format of the FIND command is: 


where: 

string specifies the information for which you are searching. If the informa- 
tion contains blanks or single apostrophes, you must enclose the 
information in single apostrophes. If the information contains single 
apostrophes, each must be entered as two single apostrophes. If the 
information contains neither blanks nor single apostrophes, you do 
not have to use the single apostrophes to enclose the information. 

P searches backward to find the previous entry (used in log browse 
only) 

N searches forward to find the next entry (used in log browse only) 

HH specifies the leftmost column for search (used in log browse only) 

rrr specifies the rightmost column for search (used in log browse only) 

Usage Note 


You can search for a previous entry or for the next entry. The default is N for next. 
You can limit columns to be searched by specifying left (Ill) and right (rrr) column 
numbers. Defaults are 1 for start (left) column and 1-255 for end (right) column (0 
is invalid). Also, the Repeat Find PF key can be used to repeat the last FIND 
command entered. 


Example 


To find the next occurrence of DSI, enter: 
F DSI or FIND DSI 


To find the next occurrence of THE NCP’S STATUS, enter: 
F 'THE NCP''S STATUS' 


To limit the search for the next occurrence of CNM to columns 1 to 20, enter: 
F CNM 1 20 


To find the previous occurrence of CNM, enter: 
FIND CNM P 
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HELP 


The HELP CLIST provides directions for moving from panel to panel in a multiple- 
page panel, or for moving through the hierarchy of status monitor panels. It pro- 
vides information on how to use the status monitor commands. HELP also provides 
access to the NetView online help facility and to the hardware monitor glossary for 
the current display. 


The format of the HELP CLIST is: 


Help = [cnmname] | 

where: 

cmdname specifies the command name. 
Usage Note 


When you enter HELP from a help screen or a command description screen, 

‘NetView presents the Screen Control/Help Display. When you enter HELP from 
another other screen, NetView presents a help menu for the current display. To 
get help for a specific command, enter HELP cmd, where cmd is the command about 
which you need more information. 


This command is not allowed if NetView is installed with the DASD Conservation 
Option. (See “DASD Conservation Option” on page 2-8.) 


Example 


To display the syntax for the DFILTER command, enter: 
HELP DF 
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MONIT 


The MONIT command does one of the following: 
e Enables the automatic node reactivation function 


e Disables the automatic node reactivation function. 


The format of the MONIT command is: 


where: 

START starts automatic node reactivation. 
STOP stops automatic node reactivation. 
ALL specifies all applicable nodes. 


ID = nodename specifies a specific node. 
Usage Note 


The only nodes that you can add to (start) or remove from (stop) the reactivation 
list are those that were not specified as NOMONIT in the file VTAMLST. 


Example 


To start the automatic node reactivation function for all nodes which have failed 
and are still inactive, enter: 


MONIT START ,ALL 
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MONOFF 


The MONOFF CLIST stops automatic reactivation of one or all resources. 


The format of the MONOFF CLIST is: 


MONOFF {ALL|nodename} 


where: 

ALL specifies all applicable nodes. 
nodename specifies a specific node. 
Usage Note 


This CLIST generates a MONIT STOP command; see page 12-6 for more information. 
Example 


To stop automatic reactivation for LINE27, enter: 
MONOFF LINE2/ 
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MONON 


The MONON CLIST starts automatic reactivation of one or all resources. 


The format of the MONON CLIST is: 


where: 
ALL specifies all applicable nodes. 
nodename specifies a specific node. 
Usage Note 


This CLIST generates a MONIT START Command; see page 12-6 for more information. 
Example 


To start automatic reactivation for LINE27, enter: 
MONON LINE27 
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NCCF 


The NCCF command is used to enter the command facility (NCCF). 


The format of the NCCF command is: 


NCCF [command | [operands]] 
where: 
command is a command facility command. If command is not specified, the 


command facility is invoked. Command facility immediate com- 
mands are not accepted. 


operands are one or more operands that are passed to the command facility 
along with the command. 


Usage Note 


If you enter NCCF without any operands, you are presented with the command 
facility screen. Then you can enter a command facility command. If you entera 
command, you must view the resulting messages and then return to the original 
screen (see “RETURN” on page 6-34) before entering more commands. 


When a command is sent to the command facility from another component, the 
command is processed by the command facility as if it had been entered directly 
from the command facility. 


When you use this command from another component, the command facility 


remains on the NetView component stack that is used with ROLL until the compo- 
nent ends. 
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PARSE 


The PARSE command allows you to see how the status monitor parses a message. 


The format of the PARSE command is: 


where: 

messagenumber identifies the number of the message. 
messagetext specifies the full message text. 
Usage Note 


The PARSE command helps the system programmer set up filter definition state- 
ments by showing how messages are parsed. 


Example 


If you are writing a filter to set off message indicator 2 for certain nodes, you need 
to know how the message is parsed. To find this information, enter: 


PARSE IST105I nodename NODE NOW INACTIVE 


Response 


The following table is displayed on your screen: 


CNM131I Element Text Delimiter 
CNM132T www ann nee enn enn een ween eee 
CNM1331 1 IST105I ny 
CNM1331 2 nodename a 
CNM1331 3 NODE mT 
CNM1331 4 NOW a 
CNM1331 5 INACTIVE - 3 
CNM1341 END OF PARSE DISPLAY 
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REPEAT (FIND) 


The REPEAT command is used while browsing a data set to reissue the last FIND 
command. 


The format of the REPEAT command is: 


Usage Note 


For more information on the FIND command, see “FIND” on page 12-4. 


PF9 is set to this command. 
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STATMON 


The STATMON command invokes the status monitor full-screen node status displays. 


The format of the STATMON command is: 


where: 

nodename specifies the name of the node for which you want information. 
Usage Note 

If you specify only STATMON, the Domain Status Summary panel is displayed. If you 
enter a node name, the Node Status Detail panel is displayed for the specified 


node name. 


When you use this command, the status monitor component will remain on the 
NetView component stack that is used with ROLL. 
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Command 


ACQ 


ACT 


ACTION 


AGAIN 


AiNQ 


ALERTSD 


ALERTSH 


ALLC 


APPLS 


APPLSACT 


APPLSPEN 


ASSIGN 


AT 


AUPD 


Appendix A. List of Commands 


This section contains an alphabetical list of commands and CLISTS that are in this 
manual. The 4700 support facility can be run in MVS and VSE only. 


An asterisk (*) is located in the component field of the commands that are not 


allowed or are allowed under certain conditions when NetView has been installed 
with the DASD Conservation Option. 


Component 


command 
facility 
command 
facility 

* hardware 
monitor 
command 
facility 
command 
facility 

* hardware 
monitor 


* hardware 
monitor 


4700 support 
facility 


command 
facility 


command 
facility 


command 
facility 
command 
facility 
command 
facility 
command 
facility 


Function 


Acquires resources that belong to another SSCP 
Activates VTAM resources 

Provides a description of a specified recommended action 
Causes the last command you entered to be rerun. 
Retrieves information from the alias translation tables 
Presents the Alerts-Dynamic display 

Presents the Alerts-History display 


Displays a summary of the 3600 and 4700 controllers in the 
network 


Displays the status of active, inactive, or all application 
program major nodes in the domain and their respective 
application program minor nodes 


Displays VTAM. applications in a specific state 


Displays sessions for particular applications in a specific 
state 


Defines which operators get unsolicited and authorized 
messages and which operators get solicited messages 


Sets a timer that causes a command to be executed at the 
specified time of day 


Alters the alias translation tables 
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Page 
3-3 


3-5 


6-3 


3-7 


A-1 


Command 
AUTOCOLL 


AUTOMSG 
AUTORECD 
AUTOTASK 
AUTOTR 


AUTOWRAP 


BACK 


BFRUSE 
BFSESS 
BGNSESS 
BOSESS 


BOTTOM 


BROWSE 
CANCEL 
CANCMD 
CCPDR 


CCPLOADF 


Component 
session monitor 


command 
facility 


session monitor 


command 
facility 


command 
facility 


command 
facility 


session monitor 
* hardware 
monitor 

4700 support 
facility 


command 
facility 


command 
facility 


command 
facility 


command 
facility 


session monitor 
* hardware 
monitor 


command 
facility 
command 
facility 
command 
facility 
command 
facility 


command 
facility 


A-2 NetView Operation 


Function 
Controls the collection of response-time monitor (RTM) data 


Activates the message automation function 


Controls the collection of accounting and resource statis- 
tics data to the external log. 


Starts the automated operator specified 


Sets the buffer trace on or off for cross-domain terminals 


Controls whether your terminal will be locked when screen 
is full of data or if and when screen will be automatically 
overlaid with new data. 


Displays a previous page of a multipage display 


Displays information about VTAM buffer usage 


Starts a full screen session with another subsystem 


Starts a session with another subsystem 


Starts an operator control session with another subsystem 


Displays the final page of a multiple-page display 


Looks at the network log or at library members 


Ends a command list (if the list is in PAUSE or WAIT) without 
running the rest of the commands in the list 


Allows you to cancel any outstanding NPS command except 
for CANCMD, DISPCMD, and MDMCNFG 


Sends dynamic reconfiguration data to a 3710 Network 
Controller 


Signals that a load sequence has completed in ccp-gener- 
ated CLISTS. 
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9-3 
3-20 


9-4 


3-23 


3-24 


3-25 


9-5 
6-6 
6-55 


3-27 


3-28 


3-29 


3-32 


9-6 
6-7 


3-33 


3-38 


3-39 


3-40 


3-44 


Command 
CCPLOADI 


CCPLOADT 


CDRMS 


CDRSCS 


CHANGEFP 


CLEAR 


CLOSE 


CLRSTATS 


CLSTRS 


COLLECT 


COMMAND 


COMMAND 


COPY 


CTRL 


CTAL (4700) 


DATE 


DDOMAIN 


DEFAULTS 


Component 
command 
facility 
command 
facility 
command 
facility 
command 
facility 


command 
facility 


command 
facility 


command 
facility 

status monitor 
command 
facility 


session monitor 


* hardware 
monitor 


4700 support 
facility 


session monitor 
* hardware 
monitor 

4700 support 
facility 


* hardware 
monitor 


4700 support 
facility 
command 
facility 

* hardware 
monitor 


command 
facility 


Function 


Signals that a load sequence has started in ccP-generated 
CLISTS. 


In ccp-generated CLISTs, it sends load text information to a 
3710 Network Controller 


Displays cross-domain resource manager (CDRM) major 
nodes known in your domain 


Displays cross-domain resource (CDRSC) major nodes 
Known in your domain 


Redefines the designated primary focal point host or both 
the designated primary and backup focal point hosts that 
receive forwarded messages and alerts from a given dis- 
tributed host 


Clears the screen 


Ends NetView 


Resets the node status analysis statistics to zero 


Displays the status of all type 1 and 2 physical units and 
their respective major nodes 


Uses the response-time monitor to gather response time 
data from 3174s 


Displays a list of all commands that you can use in hard- 
ware monitor 


Displays a list of all commands that you can use in the 
4700 support facility 


Prints a copy of the panel being displayed or sends a copy 


of the panel being displayed to the network log. 


Solicits and displays controller link test data, hardware or 
microcode levels, or error data from a specific resource 


Displays a summary of the data and status associated with 


a specified 3600 or 4700 controller and its resources 


Displays the current date and time 


Displays the identification of the current domain in which 
the specified resource resides 


Sets system-wide defaults for the logging and display of 
messages, and determines how the HOLD and BEEP actions 
are interpreted in the message automation table. 
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3-42 


3-43 


3-44 


3-45 


3-46 


3-48 


3-49 


12-3 


3-51 


9-7 


6-8 


6-56 


9-8 
6-9 
6-57 


6-10 


6-58 


3-52 


6-11 


3-53 


A-3 


. Command 


DELAY 


DELAY2 


DFILTER 


DIS 


DIS 


DISABLE 


DISCONID 


DISG 


DISKEEP 


DISPCMD 


DISPCNFG 


DISPFK 


DISPLAY 


DRATIO 


DRDS 


DROUTE 


DSISAPDR 


DWRAP 


ENABLE 


END 


Component 


command 
facility 


command 
facility 


* hardware 
monitor 


command 
facility 


* hardware 
monitor 


session monitor 


command 
facility 


command 
facility 


session monitor 


command 
facility 


command 
facility 


command 
facility 


4700 support 
facility 


* hardware 
monitor 


command 
facility 


command 
facility 


command 


_ facility 


* hardware 
monitor 


session monitor 


session monitor 


A-4 NetView Operation 


Function 


Tells the system to wait for a specified time, and then, if 
one is specified, sends a command to the system 


Issues a command and purges the timer 


Displays which recording or viewing filters are currently in 
effect 


Displays the status of system resources 
Displays the results of modem or controller tests 


Stops the collection of session awareness data by the 
access method and session monitor 


Displays Mvs console IDs used by NetView. 


Displays resource status and connectivity information for 
LUs, PUS, lines, NCPS, and major nodes 


Displays the number of Pius kept per session 


Displays a list of the outstanding NPS commands 
Displays a 3710 configuration 


Displays the PF key settings for the component you are 
using 


Displays the current 3600 and 4700 operational parameters 
associated with the specified controller 


Displays the current ratio established for the error to traffic 
alerting threshold for a specific resource 


Reconfigures an NCP with a specific dynamic reconfigura- 
tion data set or file 


Displays the status of explicit routes and virtual routes in a 
domain 


Changes the service adapter password for a 3710 
Displays the current wrap count 
Begins collection of session awareness data 


Stops the session monitor panel sequence and returns to 
the component from which session monitor was invoked 
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3-55 


6-12 


3-56 


6-59 


6-15 


3-64 


3-65 


9-11 


238 


Command 


END 


END 


ENDSESS 


ERST 


ESESS 


EVENTS 


EVERY 


EXCMD 


FIND 


FORCE 


FORWARD 


FORWARD 


FTRACE 


GENALERT 


GO 


HELP 


HELP 


HELP 


Component 


hardware 
monitor 


4700 support 
facility 


command 
facility 


* command 
facility 


command 
facility 


* hardware 
monitor 


command 
facility 


command 
facility 


status monitor 
session monitor 


session monitor 
* hardware 
monitor 


4700 support 
facility 
command 
facility 
command 
facility 
command 
facility 

* command 
facility 


* hardware 
monitor 


* session 
monitor 


Function 


Stops the hardware monitor panel sequence and returns to 
the component from which hardware monitor was invoked 


Stops the 4700 support facility panel sequence and returns 
to the component from which 4700 support facility was 
invoked. 


Ends terminal access facility sessions 


Displays the meanings of the explicit route status 


Ends terminal access facility sessions 


Displays a reverse chronological list of the most recent 
events from a specified resource 


Schedules a command to be run repetitively at intervals 


Queues a NetView command or CLIST to another task to be 
executed 


Used under BROWSE to locate information 
Causes session data to be recorded in the vSAm data base 


Displays a forward page of a multipage display 


Displays only the next page of a multipage listing 


Starts, modifies, or stops VTAM traces 


Generates an alert which can be processed by the hard- 
ware monitor. 


Allows you to resume running a CLIST that is in PAUSE or 
WAIT status 


Displays help information for NetView components and 
commands 


Provides directions for moving from panel to panel ina 
multiple page display or moving through the hierarchy of 
hardware monitor panels 


Provides directions for moving from panel to panel ina 
multiple page display or moving through the hierarchy of 
session monitor panels 
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6-17 


6-61 


3-68 


3-69 


3-70 


3-71 


3-73 


12-4 
9-13 
9-15 
6-19 
6-62 


3-74 


9-16 


A-5 


Command 
HELP 


HELP 


HELPDESK 


HEXDEC 


HOLD 


IMR 


INACT 


INACTF 


INDEX 


INPUT 


lOPD 


KEEP 


LEFT 


LINEMAP 


LINES 


LINESTAT 


LINKDATA 


LINKPD 


Component 


* status monitor 


4700 support 
facility 


* command 
facility 


command 
facility 


command 
facility 


command 
facility 


command 
facility 


command 
facility 


* command 
facility 


command 
facility 


command 
facility 


session monitor 


session monitor 


session monitor 


command 
facility 


command 
facility 
command 
facility 


command 
facility 


A-6 NetView Operation 


Function 


Provides directions for moving from panel to panel ina 
multiple page display or moving through the hierarchy of 
status monitor panels 


Provides directions for moving from panel to panelina 
multiple page display or moving through the hierarchy of 
the 4700 support facility 


Provides information to help you determine what a user’s 
problem may be 


Displays the decimal equivalent of a hexadecimal number 
Prevents the screen from unlocking until you unlock it 


Starts or stops intensive mode recording for a link station 
or physical unit 


Deactivates a VTAM resource 
Deactivates a VTAM resource with a forced deactivation 
Displays subjects discussed in the HELP facility 


Modifies the length of the command entry area of the 
regular panel 


Allows the operator to change the 1/o problem determi- 
nation time-out interval 


Changes the amount of Pius to be kept in virtual storage 


Shifts the panel left over the Session Configuration Data 
display 


Displays the Network Control Program (NCP) line port 


address associated with a station attached to an ncP within 


the same domain 


Displays the status of lines and channel links in the 
domain 


Controls a specified 3710 line 


Displays link data from a service point 


Does problem determination analysis on a given link or 
link segment 
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6-63 


3-81 


3-82 


3-83 


3-84 


3-85 


3-86 


3-87 


3-89 


3-90 


9-17 
9-18 


9-19 


3-91 


3-92 


3-93 


3-95 


Command 
LINKTEST 


LIST 


LIST 


LISTSESS 


LISTVAR 


LL2 


LOGOFF 


LOOP 


LPDA 


LSESS 


MAINMENU 


MAJNODES 


MDMCNFG 


MDMCNTL 


MENU 


MENU 


MENU 


Component 


command 
facility 


command 
facility 


session monitor 


command 
facility 


command 
facility 
command 
facility 
command 
facility 
4700 support 
facility 
command 
facility 
command 
facility 
command 
facility 
command 
facility 
command 
facility 


command 
facility 


session monitor 


* hardware 
monitor 


4700 support 
facility 


Function 


Tests a given link or link segment 
Gives information about your NetView session 
Displays a list of resources, domains, active ERs or active 


vrs, for which session data has been collected 


Displays the status of your sessions 


Displays the status of these variables: APPLID, DATE, HCOPY, 
LU, NCCFCNT, OPID, PARMCNT, PARMSTR, RETCODE, TASK, and TIME 


Requests a link level 2 test for a non-switched SDLC link 
Ends the session between your terminal and the system 
Displays the most recent status and error data for a loop 


Changes or queries the LPDA status of a line or station 
attached to a node. 


Displays the status of your terminal access facility ses- 
sions 


Displays the status of all the active major nodes in the 
domain 


Retrieves and updates the 586x configuration data 


(1) changes line speed; (2) closes or opens a contact; (3) 
dials the station; (4) disconnects the station; (5) senses 
current on a sensor relay of the modem 


Displays the menu, which is the first panel in the session 
monitor panel sequence 


Displays the hardware monitor main menu panel 


Displays the 4700 support facility panel 


Appendix A. List of Commands 


Page 
3-97 


3-99 


9-20 


3-102 


3-103 


3-104 


3-105 


6-64 


3-106 


3-108 


3-109 


3-110 


3-111 


3-114 


9-22 


6-21 


6-65 


Command 


MONIT 


MONOFF 


MONON 


MOVE 


MRECENT 


MSG 


MVS 


NCCF 


NCPDUMP 


NCPSTOR 


NETWORK 


NEWS 


NLDM 


NODE 


NOSTAT 


NPDA 


OVERRIDE 


Component 


status monitor 


status monitor 
status monitor 


command 
facility 


* hardware 


- monitor 


command 
facility 


command 
facility 


session monitor 


hardware 
monitor 
status monitor 


command 
facility 
command 
facility 
command 
facility 


command 
facility 


session monitor 


command 
facility — 


command 


facility 


* hardware 
monitor 


command 
facility 


A-8 NetView Operation 


Function 


(1) Removes nodes from the node reactivation exclusion 
list (VTAMLST); (2) adds nodes to the node reactivation 
exclusion list (VTAMLST); (3) disables the automatic node 


reactivation function; (4) enables the automatic node reac- 


tivation function 
Stops automatic reactivation of one or all resources 
Starts automatic reactivation of one or all resources 


Shifts activity from one NetView terminal to another 


Displays a reverse chronological list of the most recent 
events or statistics from the specified resource 


Enables you to write and send a message to a command 
facility operator, operators, or to the network log 


Enables you to enter an Mvs system operator command 
from NetView 


Enters the command facility 


Initiates a dump of an active NCP 


Displays the storage contents of a communications con- 
troller running an NCP 


Displays all networks defined to an NCP 
Contains messages from your network control center 


Enters the full screen mode of session monitor or proc- 
esses a Single session monitor command from a NetView 
component 


Provides information about a particular major node or 
minor node and its subordinate resources 


Stops the recording of tuning statistics 


Enters the full screen mode of hardware monitor or proc- 
esses a Single hardware monitor command from a 
NetView component 


Sets message processing options that are used instead of 
the display options selected by the message automation 
table for a particular operator. 
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12-7 
12-8 
3-116 


6-22 
3-117 
3-118 


9-23 
6-23 
12-9 


3-119 
3-121 
3-122 
3-123 


9-24 


3-124 
3-125 


6-24 


3-126 


Command 


PARSE 


PATHS 
PDFILTER 
PENDING 
PFKDEF 
PRINTLOG 


PRGATT 


PURGE 
PURGE 
PURGE 
PURGEDB 


PURGEDB 


QHCL 


QUERY PF 


QUERY 
RANGE 
RCFB 
RECORD 


RECYCLE 


REDIAL 


Component 
status monitor 


command 
facility 


* hardware 
monitor 


command 
facility 


command 
facility 
command 
facility 


* hardware 
monitor 


* command 
facility 


* hardware 
monitor 


session monitor 


* hardware 
monitor 


session monitor 


command 
facility 


session monitor 


session monitor 


* command 
facility 


session monitor 


command 
facility 


command 
facility 


Function 
Allows you to see how status monitor parses a message 


Displays dial-out path information about a switched phys- 
ical unit 


Defines the viewing and recording filters that you will be 
using during your hardware monitor session 


Displays information about nodes in the domain ina 
pending state 


Sets PF keys for an Operator Station Task (OST) for 
command facility and hardware monitor 


Prints the network log or trace log 


Removes event or statistical data for the specified 
resource and all the resources that are attached to it and 
known to hardware monitor 


Purges a timer request scheduled by the AT or EVERY 
command or purges a DST request 


Removes event or statistical data for a specified resource 
or for all resources from the data base 


Allows the network operator to delete selected data from 
the VSAM data base. 


Purges hardware monitor data. 


Purges session monitor data. 


Displays information about the hardcopy log, if one exists 


Displays the current session monitor PF key settings 


Displays the active time range from either the last SET 
RANGE Command or the default time range 


Displays information describing the specified return code 
and feedback code 


Writes accounting and resource statistics data or storage 
and cpu utilization data to the external log 


Deactivates, then activates a network node 


Requests that VTAM search for an alternate path ifa 


dial-out attempt is unsuccessful, or ends a session request 


without a search for an alternate path 
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12-10 
3-127 


6-25 


3-128 


3-129 


3-130 


6-26 


3-131 


6-27 


9-25 


6-29 


9-27 
3-133 


9-28 
9-29 


3-134 


9-30 


3-135 


3-136 


A-9 


Command 


REL 


RELCONID 


RELOAD 


REPEAT 


REPLY 


REPORTS 


REQMS 


RESET 


RESUME 


RESUME 


RETRIEVE 


RETURN 


RETURN 


RETURN 


RETURN 


RIGHT 


ROLL 


ROUTE 


Component 


command 
facility 


command 
facility 


session monitor 
status monitor 


command 
facility 


hardware 
monitor 


hardware 
monitor 


command 
facility 


* hardware 
monitor 


4700 support 
facility 


command 
facility 


command 
facility 


session monitor 
* hardware 
monitor 

4700 support 
facility 

session monitor 


All 


command 
facility 


A-10 = NetView Operation 


Function 


Releases a previously acquired ncP or releases a physical 
unit attached by a non-switched line to an NCP 


Releases the Mvs subsystem console ID that was obtained 
in a previously issued MVS command. 


Dynamically reloads the RTM PCLASS and MAPSESS or the 
KCLASS and MAPSESS definition statements 


Reissues the last FIND command, while you are browsing 
the network log 


Responds to outstanding VTAM requests 
Controls the logging of report records 


Requests SNA Summary error counts from a physical unit 
and stores the data on the hardware monitor data base 


To end the command or CLIST 


Returns to the hardware monitor panel from which you 
issued a command that took you to another NetView com- 
ponent 


Returns to the 4700 support facility display from which you 
issued another operation (for example, a command facility 
command) 


To place the last command you issued in the command 
input area 


Takes you to the previous component or the last selection 
panel 


Takes you back to a previous panel, or returns you to the 
menu 


Presents the last panel that you viewed at the previous 
level in the panel hierarchy of hardware monitor 


Displays the last display of the previous level in the panel 
hierarchy of the 4700 support facility panels that you 
viewed 


Shifts the panel right over the Session Configuration Data 
display 

Lets you go to a previous component and panel that you 
used in that component 


Lets you send NetView and vTAM commands to other 
domains 
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3-138 


9-31 


12-11 


3-139 


6-31 


6-32 


3-140 


6-33 


6-66 


3-142 


3-143 


9-32 


6-34 


6-67 


9-33 


3-144 


3-145 


Command 
RSESS 


RTREND 
RTRNSESS 


RTSUM 


RUNCMD 
RUNDIAG 


SDOMAIN 


SENDSESS 
SENSE 
SESS 

SET 

SET 


SET HEX 
SET PF 


SET RANGE 


SETCGLOB 


SOLICIT 


SRATIO 


Component 


command 
facility 


session monitor 


command 
facility 


session monitor 


command 
facility 


command 
facility 


session monitor 
* hardware 
monitor 


command 
facility 


session monitor 


session monitor 


command 
facility 


4700 support 
facility 


session monitor 
session monitor 


session monitor 


command 
facility 


4700 support 
facility 


* hardware 
monitor 


Function 


Returns the operator to a previously disconnected full- 
screen terminal access facility session 


Causes the response time trend for the named LU to be dis- 
played 


Returns the operator to a previously disconnected full- 
screen session 


Displays the response time summary for named LU 


Routes commands to service points for execution by one of 
the service point applications 


To perform online diagnostics in a 3710 


Defines the domain from which data is to be displayed 


To send a command to CICS/VS, IMS/VS Or HCF 


Displays the English interpretation of a specific SNA sense 
code 


Displays the session list for a specific resource or sessions 
between two specific resources 


Defines PA and PF keys for one session only 


Allows you to adjust the 4700 support facility operational 
parameters associated with the specified controller 


Sets hexadecimal display mode on or off 
Defines a PF key function. 


Sets the default time range that is used for all session 
monitor commands that display data by time 


Sends a message to the NetView PPT task to request that a 
specified common global variable should be set to a speci- 
fied value. 


Requests data and status from the Communications 
Network Management Controller Support in a 3600 or 4700 
controller 


Enables or disables the creation of a performance event 
for a specified resource when an E/T threshold is 
exceeded. Changes the threshold value that generates an 
alert for a specified resource 
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9-34 


3-147 


9-36 
3-149 


3-150 


9-38 
6-35 


3-151 


9-39 


9-40 


3-152 


6-68 


9-41 
9-42 
9-43 


3-154 


6-70 


6-36 
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A-11 


Command 
SRFILTER 


STACK 


START 


STARTCNM 
STARTDOM 
STATIONS 


STATMON 


STATS 
STATUS 


STOP 


STOPCNM 
SVFILTER 


SWITCH 


SWLD 


Component 


hardware 
monitor 


command 
facility 


command 
facility 


command 
facility 


command 
facility 


command 
facility 


status monitor 


* hardware 
monitor 


* command 
facility 


command 
facility 


command 
facility 


* hardware 
monitor 


command 
facility 


session monitor 


A-12 NetView Operation 


Function 


Allows you to establish the conditions governing the 
recording of data in the hardware monitor data base and 
controls the forwarding of alert data to the network oper- 
ator 


To suspend a CLIST while it is in PAUSE or WAIT status so that 
commands can be entered 


e a hardcopy log 

e aterminal in recovery status 

¢ asession between the entering operator and another 
domain 

¢ an optional task 

¢ aspan (add it to an operator’s span of control) 

e aresource within a span 


Starts NetView by component 


Starts cross-domain communications between the operator 
entering the CLIST and the domain entered. 


Displays the status of all cross-subarea stations within 
each node or for a specific node 


Invokes the STATMON full-screen node status displays 


Displays a list of the most recent statistics for the specified 
resource 


Displays information on VTAM status codes and modifiers 


e a hardcopy log | 

e aterminal in recovery status 

e asession between the entering operator and another 
domain 

e an optional task 

¢ aspan (add it to an operator’s span of control) 

¢ aresource within a span. 


Stops NetView by component 


Allows you to control which records will be displayed at 
your terminal 


Allows you to specify or control access to either the 
primary or the secondary network/trace log , or switch 
control of the DST tasks 


Switches the primary and secondary files used to store 
data on VSAM 
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3-155 


3-156 


3-158 


3-159 


3-160 


12-12 
6-42 


3-161 


3-162 


3-165 


6-43 


3-167 


9-44 


Command 


SWLOG 


SWPD 


SWRAP 


SYSMON 


TARA 


TCTRL 


TERMS 


TERR 


TEST 


THRESH 


TNSTAT 


TOP 


TOTAL 


TRACE 


TRACE 


TRANSMSG 


Component 


command 
facility 


* hardware 
monitor 


* hardware 
monitor 


4700 support 
facility 


4700 support 
facility 


4700 support 
facility 


command 
facility 


4700 support 
facility 


* hardware 
monitor 


command 
facility 


command 
facility 


session monitor 
* hardware 
monitor 

4700 support 
facility 


* hardware 
monitor 


command 
facility 


session monitor 


command 
facility 


Function 


Switches the files for the network/trace logs or stops a file 
from being used 


Switches the primary and secondary files associated with 
task BNJDSERV 


Establishes the number of event or statistical records to be 
retained for a specified resource or the total number of 
alert records to be retained on the hardware monitor data 
base 


Provides access to the System Monitor in the specified 
controller 


Enters the 4700 support facility 


Displays a summary of the data and status associated with 
a specified 3600 or 4700 controller and its resources 


Displays the status of all device-type logical units (termi- 
nals) in active major nodes 


Displays error data for a 3600 or 4700 loop 


Causes a test to be conducted of the modems and commu- 
nication facilities to a specified resource 


Displays or changes the current threshold vaiue for 
stations attached to 3710s and NcPs 


To change, restart, or stop the recording of tuning statistics 


Displays the first page of a multipage display 


Displays a count of event or statistical records for a speci- 
fied resource or resource type 


Initiates a sequence trace that records, either in virtual 
storage or on DSITRACE, a sequence of NetView processing 
steps 


Starts or stops a session trace or displays resources that 
are being traced 


Loads a set of National Language’s message translations 
defined in a member of DsimsG into NetView. 


Page 
3-169 


6-45 


6-46 


6-71 


6-72 


6-73 


3-170 


6-74 


6-48 


3-171 


3-173 


9-45 
6-50 


6-75 
6-51 


3-174 


9-46 


3-176 
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A-13 


Command 
TSOUSER 
(MVS Only) 
TSTAT 


TTERR 


TTRESP 


TUTOR 


TWERR 


TWKSTA 


TWRESP 


TWSTAT 


UNSTACK 


UPDCGLOB 


VRST 


WHO 


WKSTA 


WRAP 


A-14 


Component 


command 
facility 

4700 support 
facility 


4700 support 
facility 


4700 support 
facility 


* command 
facility 

4700 support 
facility 

4700 support 
facility 

4700 support 
facility 

4700 support 
facility 
command 
facility 
command 
facility 

* command 
facility 


command 
facility 


4700 support 
facility 


command 
facility 


* hardware 
monitor 


NetView Operation 


Function 


Displays the status of a TSO user id 


Displays the most recent status data for a 3600 or 4700 
loop 


Displays the current threshold value for the 3600 or 4700 
Loop Basic Counter 2 and extended counter threshold 
values 


Displays 3600 and 4700 response time threshold values 


Displays the panels that you have entered into the DSICLD 
library 


Displays the 3600 and 4700 error wrap count 


Displays the 3600 and 4700 most recent workstation 
response time data 


Displays 3600 and 4700 response time wrap values 


Displays 3600 and 4700 current status wrap count 


Causes a CLIST suspended by STACK to continue processing 
in the WAIT or PAUSE state 


Sends a message to the NetView PPT task to request that a 
specified common global variable should be updated. 


Displays the meaning of the virtual route status 


Lists the status of all operator terminals, command facility- 
to-command facility sessions requested by other NetViews, 
and information about your session 


Displays the most recent workstation response time data 


Changes the setting of AUTOWRAP 


Displays the definition of any term or phrase used as a 
heading on a hardware monitor display 


Page 
3-177 


6-76 


6-77 


6-78 


3-178 


6-79 


6-80 


6-81 


6-82 


3-179 


3-180 


3-181 


3-182 


6-83 


3-183 


6-52 


pork 


App 


Term 
ACCEPTABLE LIMITS 


ACT 


ACTION 


ACTIONS 

ACTIVE 

ACTIVE 

ACTIVE COUNT 
ACTIVE% 

ACTIVE SESSIONS 


ADAPTADR 


This appendix lists the fields that appear on panels for the following components: 


¢ command facility 
e session monitor 
e hardware monitor 


(Hardware monitor has its own help that you can access without going through 
the NetView help desk.) 
e status monitor 
e 4700 support facility 


The fields are listed alphabetically with a brief description of each. 


Component 


hardware 
monitor 


session 
monitor 


hardware 
monitor 


hardware 
monitor 


session 
monitor 


status 
monitor 


status 
monitor 


status 
monitor 


session 
monitor 


hardware 
monitor 


Definition 


The acceptable limits of the impairments with which the 
modem will give satisfactory operation. Except for impulse 
hits whose acceptable limit is constant, these limits may vary 
from one modem to another. 


lf the data being displayed exceeds the acceptable limits, 
then the data is colored red. 


The actual response time performance of the terminal during 
the collection period represented in the display. 


On the Session Parameters panels, it is the type of activation, 
either COLD or ERP. 


Indicates whether the data described by this detail line will 
be passed or blocked. 


The recommended action code associated with the event. 


The recommended action to isolate further or to correct the 
condition that caused the problem. 


The time the conversation was activated. 


Nodes having counts in this column monitor are in one of the 
VTAM active states (ACT), but excluding ACT/U. 


The number of times the status monitor has recorded a status 
change to ACTIVE since statistics were last initialized. 


The percentage of time the node had ACTIVE status since the 
status statistics were last initialized. 
Number of sessions using the displayed route. 


Specifies the 12 hexadecimal digit adapter address 
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B-1 


Term 
ADDRESS 


ADJACENT NETID 


ALERT DESCRIPTION: 
PROBABLE CAUSE 


AMPLITUDE 


AMPLITUDE HIT 


ANTISTREAMING 


AT 


ATTACHED RESOURCES 
EV 


AUTO ANSWER 


Component 


hardware 


monitor 


session 
monitor 


hardware 
monitor 


hardware 
monitor 


hardware 
monitor 


command 
facility 


session 
monitor 


hardware 
monitor 


command 
facility 


B-2 NetView Operation 


Definition 


The channel address of the channel adapter on the communi- 
cation controller. 


The identifier of the next adjacent network in the direction of 
the primary session partner (left) or secondary session 
partner (right). By entering left or right you can view the 
session configuration of the adjacent network. 


Briefly describes why the alert was generated and identifies 
the most likely failing components. 


An asterisk (*) in the leftmost position of the description indi- 
cates that the condition that caused the alert is being 
repeated at a rate of at least five per minute. If the field is 
enclosed in parentheses, the input record was not in a format 
predefined to HARDWARE MONITOR and therefore the text is 
based on a general interpretation of the record contents. 


A plus sign (+) in the rightmost column indicates that mul- 
tiple probable causes may be viewed on the event detail 
display. 


A value of 0 or 1 means modem is responding properly. 


Occurs when, in a 256-baud block of data, at least one baud is 
received so distorted that the modem cannot reliably correct 
it. Amplitude hits is distinguished from impulse hits on the 
display by an ‘-A’ following the number in the impulse hits 
entry. 


Applies to multipoint tributary modems. In all other cases the 
value of the antistreaming option has no effect on the 
modem’s behavior. It prevents any tributary modem ora 
multipoint network from transmitting for more than 40 
seconds in any period of time. The possible settings for anti- 
streaming are: 


Y - Yes 
N - No. 


The date and time the TRACE was set or reset. 


The total number of events present on the hardware monitor 
data base associated with all the resources attached (those 
that have a connectivity relationship, direct or indirect) to the 
resource named. 


A modem automatically answers a call if it has a yes option. 
The possible settings are: 


Y - Yes 
N - No. 


Term 
AVG 


AVG RESP TIME 


BLOCKID 


BY 


BYTE 2 


BYTE 3 


CALL PROGRESS SIGNAL 


CARRIER DETECT LOST 
(CDLST) 
CATEGORY 


CDRM 


CLEAR TO SEND DELAY 


CODE 


COMMAND 


COMMAND DESCRIPTION 


DISPLAYS 


COMMAND RETRIED 


Component 


4700 support 


facility 


session 
monitor 


hardware 
monitor 


session 
monitor 


session 
monitor 


session 
monitor 


hardware 
monitor 


hardware 
monitor 


session 
monitor 


session 


monitor 


hardware 
monitor 


hardware 
monitor 


session 
monitor 


hardware 
monitor 


hardware 
monitor 


Definition 


The average response time in seconds recorded by this timer 
during the solicitation period. This value is compared to the 
user-specified threshold (see THRESH) to determine if the user- 
specified threshold has been exceeded (See EXCEED). 


The statistical average of the response times of all the trans- 
actions within the displayed period of time. 


A code used to identify the hardware or software product that 
sent the event to the hardware monitor. 


The id of the network operator who set or reset the TRACE. 


Byte 2 of the sense code associated with session termination 
(hexadecimal). 


Byte 3 of the sense code associated with session termination 
(hexadecimal). 


This appears only for X.21 errors reported by vTAm. It indi- 


cates the progress made towards establishing the connection 


to a called number, or the circumstances that have prevented 
the connection being established. 


See the RLSD definition. 


The category byte (byte 0) of the sense code that is associ- 
ated with session termination (hexadecimal). 


The name of the sccP associated with the named domain. 


This term is also known aS READY FOR SEND DELAY. The time 
period expressed as SHORT or LONG between the DTE’s raising 
the Request To Send (RTS) and the modem’s responding with 
Clear To Send (cTS) on the EIA interface. The options (SHORT 
Or LONG) are selected with a switch on the rear panel of the 
modem. See the appropriate modem User’s Guide for exact 
values of SHORT and LONG. 


The 5 character hardware monitor code for an alert or an 
event description. 


Screen control commands. The specific session monitor 
commands that are available to you. 


Provides details of the instruction parameters and examples 
on how to use the command. 


Indicates that the local modem has retried the command to 
the remote modem because no response or an invalid 
response was received upon the first attempt. Range for 
local modem is YES or NO; range for remote modem is always 
N/A. 
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Term 
COMMANDS 


COMMUNICATION 


COMPLEMENTARY RFS 
DELAY 


CONFIGURATION 


CONFIGURATION 


CONFIGURATION DATA 


Component 


hardware 
monitor 


hardware 
monitor 


command 
facility 


command 
facility 


hardware 
monitor 


hardware 
monitor 


B-4 NetView Operation 


Definition 
A list of each hardware monitor data command and a brief 
explanation of each. You may enter a selection number from 


the Command List display in order to view the required 
command format. 


The count of the communications check errors recorded for 
the identified event. 


Ready for sending delay, applicable on multipoint tributary 
modems. Usually set to short, but may be set to long if a tele- 
communication line problem is detected when operating with 
a particular modem. A delay of between 0 to 250 ms can be 
specified in 10 ms increments. 


This refers to the type of network you wish to configure. The 
possible settings for configuration are: 


M - Multipoint which means a link or circuit intercon- 
necting several modems 

P - Point to point which means a link that connects a 
single modem to a single modem. 


You can assign different roles to your modem. In a point-to- 
point configuration, one or both of the modems is assigned 
the role of primary modem. A primary modem controls the 
speed and testing of the remote modem and link. Both 
modems may be nominated primary modems where commu- 
nication is between sites of equal importance, and speed 
control and testing may; be initiated from either end. Ina 
multipoint configuration one modem is assigned the role of 
the primary modem and several other modems are assigned 
the role of secondary or tributary modems. 


This field identifies the configuration of a modem rear panel 
switch. One of two possible values is displayed: PRIMARY 
(CONTROL) Or SECONDARY (TRIBUTARY). 


Modems on a line are set to allow one of them to control the 
speed of the others by setting this switch. The controlling 
modem is referred to as the PRIMARY in a point-to-point config- 
uration and as the CONTROL in a multipoint configuration. The 
modems being controlled are referred to as the SECONDARY or 
TRIBUTARY modems. Normally the modem at the central site is 
set to PRIMARY (CONTROL). 


For LDM, this field identifies the configuration as point-to-point 
or multipoint. 


A pictorial representation of the configuration as reported in 
the record received by the hardware monitor. Four lines are 
used to present the configuration data. The configuration 
data starts on the fourth line of each panel display except the 
recommended action display or the event detail menu where 
it starts on the third line. 


Term 
CONTROL ID 


CONTROL VECTORS 


COSNAME 


COUNT 


COUNT 


COUNTER ID 


CRW 


CRWCD 


CRWSQNO 


CS 


CTL BLK 


CTRLNAME 


CUM% 


CURRENT/ TRANSITION 
STATE OF THE EIA LEADS 


CURRENT TRANSMIT 
SPEED 


CURRENT VALUE 


Component 


session 
monitor 


session 
monitor 


session 
monitor 


session 
monitor 


4700 support 
facility 


4700 support 
facility 


hardware 
monitor 


hardware 
monitor 


hardware 
monitor 


hardware 
monitor 


session 
monitor 


4700 support 
facility 


session 
monitor 


hardware 
monitor 


hardware 
monitor 


session 
monitor 


Definition 


A symbolic name that represents installation dependent infor- 
mation about the SSCP issuing the ACTCDRsM. If there is no 
information, the field does not appear. 


Defined in SNA Reference Summary. 


The name of the class of service associated with the session. 


The notation N/A may appear instead of the class of service 
name if any NLDMs are in the configuration. 


The PiU KEEP count value for the identified session. 


The number of response time measurements recorded by this 
timer during the solicitation period. 


identifies a loop error counter. The first counter listed for 
each date or time is Loop Basic Counter 2. The format of the 
identifier is LPnn, where nn is the loop address (01-08). 


The hexadecimal presentation of the channel report word. 


The hexadecimal code that indicates the origin of the channel 
report word generation. 


The hexadecimal code for the channel report word sequence 
number. 


Contains the channel status (CS) byte (bytes) from the 
Channel Status Word (csw). It is expressed as two 
hexadecimal characters. | 


The name of an NcP control block. To the right of the value 
are hex control block data. 


See ncP and EP Reference Summary and Data Areas for 
details of the NcP control blocks. 


The physical unit name of a controller. 


The cumulative percentage of transactions in a given time 
range and all those to the left of that time range. The sum 
over all the time ranges is always 100 percent. 


Current state is not reported for RD and RLSD. Indicator will 


be shown as X. 


The speed in kilobits per second (KBPS) that the modem is 
currently transmitting. If the displayed modem speed is 
‘?KBPS’, then an invalid speed indication was received from 
the modem. 


The text invoked by the pF key number. 
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Term 


Component 


CUSTOMER CONFIG DATA hardware 


LOST 


CUSTOMER- SPECIFIED 
IDENTIFIER 


CUSTOMER INFORMA- 
TION 


CUSTOMIZATION 
DATE/TIME 


CUSTOMIZATION IDENTI- 
FIER 


DAILY E/T 


DATA RATE 
DATE/TIME 

DB 

DBM 

DEFAULT ACTION 


DEFAULT SPEED 


monitor 


hardware 
monitor 


command 
facility 
hardware 
monitor 


hardware 
monitor 


hardware 
monitor 


hardware 
monitor 


hardware 
monitor 


hardware 
monitor 


hardware 
monitor 


‘hardware 


monitor 


command 
facility 


B-6 NetView Operation 


Definition 


Indicates whether there has been some alteration of the 
modem’s non-volatile memory where its non-vital operational 
parameters are stored. Because of this alteration, the 
modem is operational with default values for its non-vital 
operational parameters. The loss of non-vital operational 
parameters does not cause the modem to indicate that the 
base modem is in error, to send a failure tone, or to leave 
data state. 


Or, indicates that the modem has not been configured at 
installation time. Possible values are YES, DEFAULTS USED or 
NO. 


This allows differentiation among system definition options, 
configurations, or capabilities. 


Up to 10 alpha numeric characters may be entered. 


The date and time when a set of executable instructions was 
customized to a user’s environment. 


The identification of a set of executable instructions, custom- 
ized to a user’s environment. | 


A ratio of the temporary error count to the traffic count 
expressed as a percentage. It is calculated only from the 
data received on the date shown under the To heading. This 
value applies to channel and link-attached communication 
control units and to channel-attached communication devices. 


Contains a FULL or BKUP (backup) designation of the data rate 
at which the modem is operating. 


The date and time the alert was recorded in the hardware 
monitor data base. 


Decibel. 


Decibel based on one milliwaitt. 


Shows the hardware monitor default that becomes effective 
when the filter elements fail to select a data record. 


The default speed is the starting speed of the modem at 
power on. The permanent storage of the modem holds a 
default speed record. It is used by all modems which have 
the speed control mode option. You can change the default 
speed to be backup speed, if you plan to operate at backup 
speed for an extended period of time. The possible settings 
are: 


F - Full speed 
B - Backup speed. 


Term 
DESCRIPTION 


DESTINATION 


DESTINATION ADDRESS 


DESTINATION NAME 


DIALING 


DIR 

DISPLAY-ID 

DLC PROTOCOL TYPE 
DOMAIN 

DOMAIN 

DOMAIN 

DTE INTERFACE CON- 


NECTION 


DTR DROP DETECTED 


DUPLEX SETTING 


Component 


session 
monitor 


session 
monitor 


session 
monitor 


session 
monitor 


command 
facility 


session 
monitor 


hardware 
monitor 


hardware 
monitor 


session 
monitor 


hardware 


monitor 


4700 support 


facility 


hardware 
monitor 


hardware 
monitor 


hardware 
monitor 


Definition 


A high-level description of the command. 


The name of the destination subarea Pu in which the dis- 
played virtual route terminates. 


The address of the subarea Pu in which the displayed virtual 
route terminates. 


The name of the destination subarea Pu in which the dis- 
played virtual route terminates. 


Selection of the type of dialing to be performed by the 
coupler, either pulse or tone (multifrequency). The type of 
dialing for the second line in a four wire coupler is the same 
as for the first one. The possible settings are: 


T - Tone or multifrequency 
P - Pulse. 


The direction of Piu flow (primary to secondary or secondary 
to primary). 


The display identification that uniquely identifies the display 
to the user. 


The data link control protocol type: synchronous (SDLC), 
binary synchronous (BSC), or synchronous start-stop (S/s). 


The command facility domain from which the panel data was 
retrieved. 


The name of the domain associated with the resource. 


The name of the domain that the 3600 feature is monitoring. 


Indicates whether the modem’s DTE interface is connected to 
a DTE or another modem. 


The data terminal ready values are shown as YES Or NO. YES 
is displayed if DTR has dropped at least once since the last 
LPDA status report. If DTR DROPis not detected and a fanout 
configuration exists, N/A will be displayed. ‘No’ is the normal 
value. 


This tells whether the link is half duplex or full duplex. 
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Term 


EIA LEAD INDICATOR 
DEFINITIONS 


EIA LEAD FANOUT CON- 
SIDERATIONS 


ELAPSED TIME 


ELEMENT 


EMULATED PRODUCT 
MACHINE TYPE — 


EMULATED PRODUCT 
MODEL NUMBER 


Component 


hardware 
monitor 


hardware 
monitor 


status 
monitor 


session 
monitor 


hardware 
monitor 


hardware 
monitor 


B-8 NetView Operation 


Definition 


The current and transition states of EIA leads are shown on 
the Remote DtE Interface Status Display panel by the charac- 
ters N (off), X (not reported), and Y (on). This is applicable 
only to LPDA-1. The transition states are ‘Y’ under these con- 
ditions: 


e cTs - Clear to Send was on at least once since the last DTE 
test or is still on. 


¢ DTE POWERLOSS - Power was off at least once since the 
last DTE test or is still off. 


e pTR - Data Terminal Ready was off at least once since the 
last DTE test or is still off. 


e RD - Data was received since the last DTE test. 


¢ RSLD - Receive Line Signal Detect was off at least once 
since the last DTE test or is still off. 


¢ RTS - Request to Send was on at least once since the last 
DTE test or is still on. 


¢ SPEED - Changed at least once since the last DTE TEST. 
e TD - Data was transmitted since the last DTE test. 


For multipoint and for non-continuous-carrier, point-to-point 
operation, CTS and RTS ‘current stat’ leads normally show an 
‘N’. For continuous-carrier, point-to-point operation these 
leads normally show a ‘y’. Variations from these values indi- 
cate an exception condition. 


CTS and ATS ‘transition stat’ leads normally show a ‘y’. The 
display of an ‘y’ notes that the lead has turned off and 
remained off since the last remote DTE interface command 
was received, indicating an exception condition. 


The EIA indicators may not fully represent conditions of the 
interface when the fanout feature is installed on the remote 
device. Actual problem determination may have to be done 
by powering up one terminal at a time and observing the EIA 
lead states. 


The elapsed time since the status statistics were last initial- 
ized. 


The element address, (hhhh) on the panel, associated with 
the gateway resource. 


The type of hardware product being emulated, if emulation is 
being done. 


The model number of the hardware product being emulated, 
if emulation is being done. 


Term 
END TIME 


ER 


ER iNOP 


ERROR BYTES 


ERROR DESCRIPTION 


ERRORS 


ERRS 


E/T CALC or 
ERROR/TRAFFIC CALC 


Component 


session 
monitor 


session 
monitor 


session 
monitor 


4700 support 
facility 


hardware 
monitor 


hardware 
monitor 


hardware 
monitor 


hardware 
monitor 


Definition 


The end time of the session in month/day hour:minute:second 
format for inactive sessions that set up successfully. The end 
time is given as “***AcTIvE***” for active sessions, as 
“***BINDF***” for sessions that failed to set up because of BIND 
failures, and as “***iNiTF***” for sessions that failed to set up 
before the BIND flow. The pseudo session for discarded Pius 
is considered to be an active session. 


The number of the explicit route used by the session. 


The notation NA may appear instead of the ER number. This 
means the network of the operator making the request is not 
authorized to view the specific configuration data of the 
network displayed, or the numbers were not supplied by VTAM 
in session awareness data. 


This field contains INOP if ER-INOP has been received. If no 
ER-iNOP has been received, this field is left blank. 


For an extended statistical counter, the number of bytes in 
error that have been received from input devices during the 
indicated solicitation period. 


This presents a description of the condition that caused the 
event to be generated. 


Error types can be as follows: 


® COMMUNICATION - The count of the communication check 
errors. When this value is 0, display HARDWARE 
MONITOR-43P (Shown in upper left corner of your screen) 
appears; however, when a communication check error 
count is at least one, the SNA Event Summary display 
appears. 


¢ PRODUCT - The count of the product check errors. Product 
check errors are generally due to internal hardware 
errors. 


® SNA NEG-RESPONSE - Counts the number of times the identi- 
fied unit originated a SNA negative response. 


Count of communications check errors of the type identified. 
N/A is displayed when the counter is not supported by the con- 
troller. 


A ratio (shown as a percentage) of temporary errors to traffic, 
for the statistical record. 
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B-9 


Term Component 


E/T SET or hardware 

ERROR/TRAFFIC SET monitor 

E/T hardware 
monitor 


B-10 NetView Operation 


Definition 


The threshold value used by the hardware monitor to deter- 
mine if the E/T RATIO CALC value indicated a performance 


‘problem. This threshold value is established by: 


e The SRATIO command 

e Initialization parameters 2 

¢ Default (at 3.0% for network controllers or 1.0% for 
channel attached communication control units and 
devices).. 


A ratio of temporary errors to total traffic calculated by the 
hardware monitor and shown as a percentage. 


Term 


ETYP Or EVENT TYPE 


Component 


hardware 
monitor 


Definition 


This event type code refers to the type of data associated with 
the alert or event found in the Most Recent Events displays as 
follows: 


AVAL - Availability. A network component that was previ- 
ously unavailable when its service was required is now 
available 


Cust - Customer application. A program that does not 
have an IBM order number generated the alert or event. 


DLRC- Delayed-recovered. The sender is reporting 
recovery from a condition that occurred earlier. 


ENV - Environment. A physical environmental problem 
has occurred. 


HELD - Alert condition was detected earlier, but the alert 
was not sent at that time because there was no session 
available to send it on. 


IMPD - A loss of availability to the end user is impending 
but has not yet happened. 


IMR - Intensive mode recording. Records resulting from 
the user invoking intensive mode recording. When 
invoked, each time the NCP goes through an error 
recovery, an IMR record is sent to hardware monitor. 


INST Installation. A system definition or incompatibility 
problem between components has been reported. 


INTV - Intervention required. Intervention of a human 
operator is required. 


NTFY - Notification. An important change of component or 
network status requiring operator notification has 
occurred. 


PAFF - Permanent-affected. A resource has been lost 
because of an error in another resource. 


PERF - Performance. A recognized measurement of per- 
formance has exceeded a predetermined threshold. 


PERM - Permanent error. An error has occurred that is not 
recovered by the detecting component without external 
intervention. 


PROC - Operation or procedure. This type indicates the 
inability to perform a requested function because of an 
operational or procedural error. 


SCUR - Security. This type is used to report system- 
detected incidents that indicate exposure to security 
problems. 
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Term 


ETYP or EVENT TYPE 
(cont.) 


EVENT 
DESCRIPTION: PROBABLE 
CAUSE 


EXAMPLES 


EXCEED 


EXTERNAL CLOCK LOST 


FAILURE CAUSED 


FAILURE TONE, AGE 


FAULT DOMAIN 


FEATURE(S) IN ERROR 


FEATURES INSTALLED 


Component 


hardware 
monitor 


hardware 
monitor 


session | 
monitor 


4700 support 
facility 


hardware 
monitor 


hardware 
monitor 


hardware 
monitor 


hardware 
monitor 


hardware 
monitor 


hardware 
monitor 


B-12 NetView Operation 


Definition 


e SNA -SNA Summary. A record that contains SNA summary 
error counters. It is normally the result of an hardware 
monitor solicitation. 


¢ TEMP - Temporary error. An error that is recovered, yet it 
is recurring at a rate that may affect operation. 


® UNKN - It is impossible to assess the severity of the alert 
condition. 


® USER - End user generated. A record is initiated by a ter- 
minal operator. 


This briefly describes why the alert was generated in an 
event. It also identifies the most likely failing components. 


An asterisk (*) in the left-most position of the description indi- 
cates that the condition that caused the event is being 
repeated at a rate of at least five per minute. If the field is 
enclosed in parentheses the input record was not in a format 
predefined to the hardware monitor and therefore the text is 
based on a general interpretation of the record contents. 


A plus sign (+) in the rightmost column indicates multiple 
probable causes may be viewed on the event detail display. 


These are examples of commands from the Help series 
panels. 


Indicates whether the user-defined minimum threshold was 
exceeded. YES indicates that the threshold was exceeded and 
an alert was generated. A blank field indicates that no 
threshold was exceeded. 


indicates whether external clock option is active in modem 
configuration and no clock is provided by DTE. Possible 
values are N/A for the local modem, YES or NO for remote 
modem. 


A list of possible causes for the conditions which are the 
result of failures in the hardware, software, environment, ora 
combination of the three. 


Tells whether a failure tone was detected and, if so, the age 
when the last failure tone was detected. Possible values for 
FAILURE TONE are YES and No. The range for AGE is from 1 
second to 2 minutes, or is left blank. 


The pair of LAN stations (for token-ring LANS) that make up a 
fault domain (two LAN stations and the cabling between them). 


Contains a list of modem features in error. Possibilities are 
NONE, FAN OUT, and COUPLER. 


This is the list of features installed, such as TAC or SNBU. If no 
features are identified, “NONE” will appear. 


Term 
FID 


FILTER TYPE 


FM PROFILE 


FM USAGE/PLU 
FM USAGE/SLU 
FORMAT 


FREQUENCY SHIFT 


FROM 


FROM, TO 


GATEWAY NAU 


GENERAL 
GLOBAL TRACE 
GLOSSARY 


HEXADECIMAL DISPLAY 
OF DATA RECORD 


HOST: host-name 


Component 


session 
monitor 


hardware 
monitor 


session 
monitor 


session 
monitor 


session 
monitor 


hardware 
monitor 


hardware 
monitor 


hardware 
monitor 


session 
monitor 


session 
monitor 


hardware 
monitor 


session 
monitor 


hardware 
monitor 


hardware 
monitor 


status 
monitor 


Definition 


Format Identifier; it may be 0, 1, or 4. 


Identifies the specific filter being displayed. 


® AL RECORDING - Alert Recording 

¢ EV/ST RECORDING - Event/Statistical Recording 

® NCCF AUTH OPER - the command facility Authorized Oper- 
ator 


Function Management Profile; may be 0, 2 through 7, 17, or 
18. 


For the Session Parameters panel, it may be 0, 2 through 7, 
or 17 through 19. 


Defined in SNA Reference Summary. 
Defined in SNA Reference Summary. 
A description of the information common to all displays. 


The difference between the frequency of a transmitted signal 
and the frequency of the same signal as seen by the modem 
at the other end of the line. The field can contain N/A or N/AV. 


The date and time associated with the oldest event or statis- 


tical record (as appropriate to the display) received since the 


data base was initialized or since the last purge for this 
resource. 


The starting and ending dates and times. If the starting and 
ending dates are the same, only the starting date is dis- 
played. 


This designates a gateway resource representation for the 
primary or secondary session partner residing in another 
network. 


The general cause code indicating the general classification 
and cause of the condition (event) that was not expected. 


The current setting of the TRACE ALL function in the Display 
Trace panel. The value is ON or OFF. 


A description of the contents of the fields presented on the 
current hardware monitor display panel. 


The contents of the data record displayed in hexadecimal 
form. 


It is the host on which the status monitor is running. The 
host-name is constructed from the host subarea number and 
appears on every display. 
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Term 


IBM PLANT OF MANUFAC- 
TURE 


IMPULSE HIT 


INACT 


INACT COUNT 


INACT% 


INN 


INSTALL CAUSED 


INSTRUCTION ADDRESS 


INTERVAL 


Component 


hardware 
monitor 


hardware 
monitor 


hardware 
monitor 


status 
monitor 


status 
monitor 


status 
monitor 


session 
monitor | 


hardware 
monitor 


hardware 
monitor 


4700 support 


facility 


B-14 NetView Operation 


- Definition 


The plant of manufacture, or 00 if the plant of manufacture is 
not required to uniquely identify the product instance identi- 
fier. 


Can be one of the following: 


e A unique physical unit identification of the SNA controller 
expressed is eight hexadecimal characters. The first 
three characters are the machine type designator, the 
last five are device dependent. This is followed by the 
IBM machine type designator (within parentheses) when 
the designator can be interpreted. 


e The hardware monitor-designed product code in the first 
12 bits of the identifier, which is used internally to identify 
hardware and software products. 


e The serial number (VOLSER) of the volume on the 1/0 
device at the time of the event. 


e The serial number of the printer. 
e The IBM machine type designator. 


The number of impulses occurring within a 100-msec. window 
that are above a threshold of 6 dB relative to the average 
signal power at the input of the modem. The number dis- 
played is the number of impulse hits that have occurred 
within the last 15 minutes. . 


N/A FOR PROBE when a 3867 line probe is installed. 


Inactive node counts are in this column and reflect those 
nodes that have been deactivated by an operator command 
or have been deactivated by VTAM automatically. 


The number of times the status monitor has recorded a status 
change to INACT since the analysis statistics were last initial- 
ized. 


This column contains the percentage of time the node has 
been in the INACT state since the status statistics were last ini- 
tialized. 


A subarea (intermediate network node) in the path of the 
explicit route. 


A list of conditions for the problem that are the result of activ- 
ities surrounding the installation of new or updated hardware 
or software. 


The 37xx address of the exception instruction recorded in the 
lagging address register (LAR). 


The current timing interval (expressed in seconds) used by 
the communication network management controller support 
(CNM/CS) to check for changes in loop status. 


Term 
iSTTSXMM 


JOBID 


KBPS 


KEEP TYPE 


KY 


LAN 


LAST TRANS TIME 


LDM REINITIALIZATION 


LEASED OR SWITCHED 
SETTING 


LEAST RECEIVE LEVEL 


LINE ANALYSIS (LA) 


LINE QUALITY 


LINE TYPE 


LINE TYPE, MODE 


LINK CONFIGURATION 


LINK CONFIGURATION 
TYPE 


Component 


session 
monitor 


hardware 
monitor 


hardware 
monitor 


session 
monitor 


session 
monitor 


hardware 
monitor 


session 
monitor 


hardware 
monitor 


hardware 
monitor 


hardware 
monitor 


hardware 
monitor 


hardware 
monitor 


hardware 
monitor 


hardware 
monitor 


hardware 
monitor 


hardware 
monitor 


Definition 


The CSECT name of the VTAM module that determined the Plu 
should be discarded (mm = module identifier). 


The name of the job (identified by the yoB ucL statement) that 
was being executed at the time of the event. 


Kilobits (1000 bits) per second. 


The type of KEEP COUNT being displayed on the panel. The 
type can be Pius. 


The pF key number (01-24). 
Local area network. 


The response time of the last transaction that occurred during 
the displayed period of time. 


Limited Distance Modem (LDM) reinitialization indicator is set 
on when the modem is powered on, or when it is reset ona 


_ hard/soft error. 


Tells whether the link is leased or switched. 


The value of the last received dBm level measurement during 
the 15 minutes before the command was executed or since 
the last modem reinitialization. 


Test in which the modems respond with the analog parame- 
ters of the line. 


A modem-calculated running average ranging from 0 to 14 for 
LPDA-1 and from 0 to 14 for LPDA-2 that shows the quality of the 
signal received by the modem. A value in the range of 0 to 4 
is considered GooD. The range of 5 to 9 is considered inde- 
terminate, and the range of 10 to 15 is considered BAD. This 
field should contain ‘N/Av’ if the quality could not be meas- 
ured. 


Indicates the type of line as leased or switched. For the Lp, 
line type should always be leased. 


This indicates the type of line as 2 wire leased or 4 wire 
leased. Note that an LDM line is always leased. 


The modem and link configuration of the link. 


Range iS SWITCHED PRIME Or LEASED, POINT TO POINT, Or MULTI- 
POINT. 
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Term 
LINK OWNERS 


LINK SEGMENT LEVEL 


LINK STATION TYPE 


LIST TYPE 


LOCAL LDM 


LOCAL LOOP BACK WRAP 


LOCAL MODEM 


LOCAL NETID 


Component 


session 
monitor 


hardware 
monitor 


hardware 
monitor 


session 
monitor 


hardware 
monitor 


command 


facility 


hardware 
monitor 


session 
monitor 


B-16 NetView Operation 


Definition 
Can be one of the following: 


e sscPp - The names of sscps that own links in the selected 
transmission group. A list of such sscps is provided for 
both SUBAREA1 and SUBAREA2. 


¢ TGN - The number of the selected transmission group. 


Indicates whether the command was sent to the primary link 
segment or to a tailed link segment of the line. If this field 
contains ‘FF’, then the local modem configuration either has 
not been initialized or has been altered such that its address 
has been set to the default value of x‘FF’. 


Tells the type of link station: PU TYPE 1 (Terminal Node), Pu 
TYPE 2 (Cluster Controller), PU TYPE 4 (Communication Con- 
troller), or NON-SNA (BSC DEVICE). For SNA devices, it also tells 
whether the link station is primary or secondary. 


The status of the list requested and the type of list requested. 


_ The list status can be ACTIVE, HISTORY, or ALL. If no status is 


specified the default if ACTIVE. The list type can be LU, SLU, PLU, 
Pu, or SSCP. If no LIST TYPE is specified the default is LU. 


Identifies the local LDM machine type. IBM MODEM is displayed 
if local self-test results indicate not executed, no response, or 
bad response. 


If the test control lead is active, the modem loops back data 
to the DTE for checking. The possible settings are: 


Y - Yes 
N - No. 


The local modem machine type. IBM MODEM is displayed if the 
test results indicate not executed, no response, or bad 
response. 


The modem that receives LPDA-2 commands from its DTE inier- 
face not its line interface. 


The name of the network whose session configuration data is 
being displayed. 


Term 


LOCAL/REMOTE MODEM 
DATA 


Component 


hardware 
monitor 


Definition 


Each contains the following pieces of information about the 
local and remote modems on the line (LPDA-2): 


FREQUENCY SHIFT- The difference between the frequency of 
a transmitted signal and the frequency of the same signal 
as seen by the modem at the other end of the line. Meas- 
ured in HZ (Hertz); may also contain N/A (not applicable) 
or N/AV (not available). 


IMPULSE HITS- Contains the number of impulse hits meas- 
ured during the last 15 minutes, or N/A (not applicable), to 
this this product or to this configuration. 


LINE QUALITY - Contains the line quality expressed as a 
quadratic error (for example, frequency distortion or 
phase jitter) for the local or remote modem. Numeric 
values 0 to 4 are qualified with the word GooD, 5 to 9 are 
not qualified, 10 to 15 are qualified with the word BAD N/Av 
indicates not available. 


PHASE JITTER - The phase modulation, expressed in 
degrees peak-to-peak (DEG PP), imposed by the channel to 
a 1004-Hz tone; may also be N/A (not applicable) or N/AV 
(not available). 


RCV LEVEL - Contains the value of the receive DBM level 
measurement. Values range from -45 to 3, or N/A (not 
applicable), or N/AV (not available). 


RCV LEVEL, LEAST - RCV LEVEL contains the value of the 
receive level measurement in decibels based on 1 milli- 
watt (DBM), N/A (not applicable), or N/AvV (not available). 
LEAST contains the value of the least receive level meas- 
urement during the last 15 minutes in (DBM),N/A (not appli- 
cable), or N/AV (not available). 


RE INT - Contains a YES or NO indication as the reinitializa- 
tion of the local or remote modem. 


RLSD LOSSES - Contains the number of line drop-outs 
during the last 15 minutes, or N/A (not applicable) to this 
product or to this configuration. 


ROUND TRIP DELAY - The difference between the time a 
command is sent and the time an acknowledgement to 
that command is received, as measured in milliseconds 
at the local modem; or N/Av when not available. 


SIGNAL TO NOISE RATIO - Contains the value of the signal to 
noise ratio in decibel (DB), N/A (not applicable), or N/AV 
(not available). 


SPEED, RMT MODEM ADDRESS - SPEED contains the current 
transmit speed between local and remote modems. The 
valid speeds are 0.6, 1.2, 2.4, 4.8, 7.2, 9.6, 12.0, 14.4, 16.8, 
19.2, 56.0, and 64.0 kbps. This field also displays the 
speed rate which can be FULL or BkuP (backup). 
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Term 


LOCAL/REMOTE MODEM 
DATA (cont.) 


LOCAL STATION DLC 
ADDRESS 


LOCAL STATION LAN 
ADDRESS 


LOCAL STATION SNA 
NAME 
LOGMODE 


LOOPNAME 


LOOP STATS 


Component 


hardware 
monitor 


hardware 
monitor 


hardware 
monitor 


hardware 
monitor 


session 
monitor 


4700 support 
facility 


4700 support 
facility 


B-18 NetView Operation 


Definition 


TRANSMIT LEVEL - Contains the value of the transmit level 
measurement in decibel based on 1 milliwatt (DBM), N/A 
(not applicable), or N/Av (not available). 


TYPE-MODEL, CMD RETRIED - TYPE contains the four-character 
modem type. MODEL contains the 2-character modem 
model type. CMD RETRIED contains a YES/NO to indicate 
whether the local modem has retried the command to the 
remote modem because no response or an invalid 
response was received upon the first attempt; this field is 
always N/A (not applicable) to the remote modem. RMT 
MODEM ADDRESS contains the address of the remote 
modem which is the target of the command; for the local 
modem this field is always N/A (not applicable). 


2ND HARMONIC DISTORTION - The measurement, expressed in 
dB (decibels), of the non-linear distortion characteristics 
of the channel; may also be N/A (not applicable) or N/Av 
(not available). 


3RD HARMONIC DISTORTION - The measurement, expressed in 
dB (decibels), of the non-linear distortion characteristics 
of the channel; may also be N/A (not applicable) or N/AV 
(not available). 


The DLc address of the local physical link station. 


The LAN address of the local physical link station. 


The SNA name of the local physical link station. 


The LOGON mode name associated with the session. 


The loop name (LPnn) of the selected loop. 


loop status as follows: 


BAS2 - The number of loop errors (Loop Basic Counter 2) 
that occurred during the last solicitation period. 


%ERR - For an extended statistical counter, the per- 
centage of bytes in error sent during the last solicitation 
period. 


STAT - Indicates the current operational status of each 
attached loop (OPT = operative, INOP = inoperative). 


Term 
LOST RLSD 


LPDA MICROCODE LEVEL 


LUNAME 


LVL 


MACHINE MODEL 


NUMBER 


MACHINE TYPE 


MAX 


MDMCNFG 


MESSAGE 


MICROCODE LEVEL 


MM/DD HH:MM 


MODEL 


MODEM AND LINE 
STATUS 


MODEM SENSE 


MODEM REINT 


Component 


hardware 
monitor 


hardware 
monitor 


session 
monitor 


session 
monitor 


hardware 
monitor 


hardware 
monitor 


4700 support 
facility 
command 
facility 


hardware 
monitor 


hardware 
monitor 


4700 support 
facility | 


hardware 
monitor 


hardware 
monitor 


hardware 
monitor 


hardware 
monitor 


Definition 


Receive Line Signal Detect. A YES or NO value indicating that 
the modem detected an unexpected loss of carrier for some 
period of time or that a noise burst of sufficient amplitude and 
duration caused the modem to lose synchronization. If the 
modem configuration is multipoint, the N/A is displayed for the 
local modem. 


A number (0-15) which identifies the link problem determi- 
nation aid microcode level installed in the modem. 


The LU name of the terminal for which the response time is 
displayed. 


The control block level. 
The model number of the machine. 
A four-digit descriptor of the machine type. 


The maximum response time in seconds recorded by this 
timer during the solicitation period. 


The command that retrieves and updates the 586x modem 
configuration data. 


The line used by hardware monitor to provide the user with 
error, information, or data messages. 


A decimal number which identifies the microcode level 
installed in the LDM. 


The date and time that the immediately preceding Communi- 
cation Network Management (CNM) data was recorded. 


A two character modem model. If ‘c’ is displayed, indicates 
that the modem is in an operating mode and at a speed that 
is compatible with S865/S868-2 modems. 


Detailed modem information for link segment 1 or 2, as indi- 
cated. 


When this data field is displayed, then a modem execution 
exception has occurred during the processing of the 
command. The modem sense code is displayed, anda 
description of the exception is stated on the message line. 


The modem reinitialization indicator is set on when the 
modem is powered on, when it is reset on a hard or soft 
error, or for 386X modems, by a change to a modem setup 
switch. 
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Term 
MONIT 


MR 


MSEC 


N/A 
N/AV 


NAME 


NAME 

NCP LEVEL 
NCP Te 
NEGOTIABLE 


NETID 


NETWORK FUNCTION 


Component 


status 
monitor 


hardware 
monitor 


hardware 
monitor 


session 
monitor 


hardware 
monitor 


hardware 
monitor _ 


session 
monitor 


4700 support 
facility 


session 
monitor 


session 
monitor 


session 
monitor 


session 
monitor 


hardware 
monitor 


B-20 NetView Operation 


Definition 


This column contains the number of nodes being monitored 
for automatic reactivation at the present time. These nodes 
are currently inactive but are not included in the INACT 
column. 


An indicator of y signifies that most recent statistical data is 
present for the resource associated with the selection 
number. If most recent statistical data is not available, the 
field is left blank. 


Milliseconds. 


N on the Session Trace panel indicates a note. In this 
column, there may be a blank, meaning the Plu is complete, a 
D means the plu is discarded, or a T means the piu has been 
truncated. 


Not applicable. 


Not available. 


The network names for which the session monitor has data 
that corresponds to each display panel option in the session 
monitor. For example, in panel NLDM.TG, it is the name of the 
subarea as known by the indicated sscp. 


Identifies the resource by symbolic name (physical unit 
name, LPnn, or wsnn). 


The level identifier supplied by NCP. 


The version level of the ncp. Note: If the VERSION data is 0, 
the corresponding field and heading are not displayed. 


Negotiable BIND, value can be YES or NO. 


The identifier of the network in which the primary or sec- 
ondary session partner resides. 


In the Resource Name List panel, the nefid would be the iden- 
tifier of the network specified in the List LU command. In the 
List of Explicit Routes panel, the netid is the name of the | 
network specified in the List ER command. Only those Lus 
and ERS in the specified network that are known by that 
domain are displayed. 


Indicates the function of the modems in the network as 
PRIMARY, SECONDARY, CONTROL, OR TRIBUTARY. 


Term 
NETWORK FUNCTION 


NEVACT 


NLDM FILE LAST INITIAL- 
IZED 


NMVT 


NO TRANS 


NODE ID 


NODES 
(TOTAL/MIGRATION) 


NODE TOTALS 


NODE TYPE 


NOISE COUNT 


Component 


command 
facility 


status 
monitor 


session 
monitor 


hardware 
monitor 


session 
monitor 


status 
monitor 


session 
monitor 


status 
monitor 


status 
monitor 


4700 support 


facility 


Definition 


A modem’s relationship to its placement on a link of a given 
topology. The possible settings for network function are: 


C - Control on a multipoint link / Primary on a point to 
point link 

S - Secondary on a point to point link / Tributary on a 
multipoint link ; 


Never Active status counts appear here and refer to those 
nodes that have not been activated with an operator 
command or have not been activated automatically by VTAM. 


The date on which the SESSION MONITOR VSAM data base was 
last initialized (mm/dd/yy format). 


The type of network management vector transport record 
through which statistical data or information about an event 
was reported. 


This appears when no transactions have occurred for this col- 
lection period. 


The node name. 


The number of total nodes and the number of migration 
(down-level) nodes. The difference between these two 
numbers is the number of nodes displayed on the panel. 


This column contains the row status totals for each node type 
and, because it contains all possible states, it is also the total 
count of nodes of the corresponding type in the domain 
defined to the status monitor. 


This column contains the abbreviated names for the types of 
nodes defined to the status monitor. 


For Loop Basic Counter 2, a count that reflects errors 
incurred on the loop during the last solicitation period. 


This counter is incremented once for every 16 hours. The 
Loop Basic Counter 2 is not reset upon solicitation. The 
incremental change during the last solicitation period is cal- 
culated and displayed by the 3600 feature. 


If the counter has reached its maximum value of 255, the 
noise count value is immediately followed by an asterisk (*). 
The 3600/4700 control program does not increment the 
counter until the counter is reset to zero by an IML or system 
monitor command. 


The noise count value is expressed in units of s per solicita- 
tion period, where the solicitation period is defined as the 
time difference between the last two consecutive solicitations 
for the particular loop. The noise count value is internally 
converted to errors per hour and then compared to the user- 
specified threshold (see THRESH) to determine if the user- 
specified threshold has been exceeded (see EXCEED). 
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Term 
NPDA PROMPT LINE 


N-/T-/A 


NUMBER OF LINK SEG- 
MENTS ACTIVE ON THIS 
LINK CONNECTION 


NUMBER OF TRANS 


OBJ 


OPERATION 


OPSW 


ORIGIN 


ORIGIN ADDRESS 


ORIGIN NAME 


OTHER 


Component 


hardware 
monitor 


hardware 
monitor 


hardware 
monitor 


session 
monitor 


session 
monitor 


hardware 
monitor 


hardware 
monitor 


session 
monitor 


session 
monitor 


session 
monitor 


status 
monitor 


B-22 NetView Operation 


Definition 


The prompt line indicates the most common options which 
the user might select from the current display panel. 


This indicates that the filter entry relates to a resource name 
or type as follows: 


e n- The filter element applies to records pertaining to the 
named resource only. 


e NREF - The filter element applies to records pertaining to 
the named resource or records. that include the named 
resource in the HARDWARE MONITOR NAME/TYPE list. For 
example, if a line is named, all records that contain that 
line name are affected by this filter. 


e 1T- The filter element applies to all records pertaining to 
the specified resource type. 


e TREF - The filter element applies to records pertaining to 
the specified resource type or to records that include the 
resource type in the HARDWARE MONITOR NAME/TYPE list. For 
example, if a type of LINE is specified, all records that 
contain that type of LINE are affected by this filter. 


Tells the number of active link segments on the link. 


The number of transactions that occurred during the dis- 
played time period. If this value is less than 10, this line is 
shown in red on acolor screen or highlighted on a 
monochrome device. 


The response time performance objective, or target, specified 
on the PCLASS initialization statement. This value is shown 
graphically by the downward- pointing arrow that appears 
immediately below the oBu statement. 


A detailed description of the operation being executed at the 
event (error) occurred. If not available, N/A will be displayed. 


The contents of the old program status word (PSW) associated 
with the machine check. 


The name of the origin end point subarea Pu for the displayed 
route 


The address of the origin end point subarea Pu for the dis- 
played route 


The name of the subarea end point Pu for the displayed route 


This column contains the names of nodes that have a vTAM 
status other than those statuses represented in the status 
monitor columns ACTIVE, PENDING, INACT, MONIT, AND NEVACT. 


Term 
OTHER COUNT 


OTHER% 


OVRN 


PACING COUNT 


PAGE 


PARMS 


PATH 


PCLASS NAME 


PENDING 


PENDING COUNT 


PENDING% 


PERFORMANCE CLASS 


PG 


PHASE JITTER 


PORT ADDRESS 


Component 


status 
monitor 


status 
monitor 


hardware 


monitor 


session 
monitor 


session 
monitor 


session 
monitor 


hardware 


monitor 


session 
monitor 


status 
monitor 


status 
monitor 


status 
monitor 


session 
monitor 


session 
monitor 


hardware 


monitor 


hardware 


monitor 


Definition 


The number of times STATMON has recorded a status change 
to other than ACTIVE, PENDING, OR INACT since the analysis sta- 
tistics were last initialized. 


The percentage of time the node had a status other than 
ACTIVE, PENDING, OR INACT since the status statistics were last 
initialized. 


The number of read operation overruns. 


This line appears on the panel only if TYPE=RSP. For more 
information, see SNA Reference Summary. 


Number of page. 
The parameters for the display control commands. 


For mvs/370, the secondary channel unit address (SCUA) that 
indicates the path at the time the event occurred. This may 
reflect a channel different from the one indicated in the 
resource name, which is the Primary-Channel-Unit-Address 
(PCUA). Error counts are always charged and displayed 
against the PCUA. 


For MVS/XA, a 1-byte channel path identification is followed by 
a 2-byte logical device number. 


The performance class name of the session displayed. 


These nodes are in one of the pending states (ACT/U, PSUB1, 
PACTL, and so on). 


The number of times the status monitor had recorded a status 
change to PENDING since the analysis statistics were last ini- 
tialized. 


The percentage of time the node has been in PENDING status 
since the status statistics were last initialized. 


The performance class the terminal LU was assigned to 
during the displayed time period. 
Displays a Trace Series panel for a Primary Gateway Trace. 


Disturbance on the line. 


The port address of the link. 
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Term 
POSITION 


Component 


hardware 


Definition 


For the channel adapter and communications scanner dis- 


POWER DROP DETECTED 


monitor 


plays, the Pos field contains: 


e The communication scanner position 
e The channel adapter position in the communication con- 
troller 


A value of YES or NO that relates to the power and cabling of 


POWER LOSS DETECTED 


POWER-OFF TONE 


*PRIMARY* DOM 


PRIMARY EL 


PRIMARY KNOWS SEC- 
ONDARY BY ALIAS 


hardware 
monitor 


hardware 
monitor 


hardware 
monitor 


session 
monitor 


session 
monitor 


session 
monitor 


B-24 NetView Operation 


the remote device. A value of YES indicates the remote 
device has dropped power or become disconnected from the 
modem at lease once since the last LPDA status report. The 
normal value is NO. When fanout is installed, a power drop is 
detected only when all attached DTE’s drop power. 


A value of YES, NO, or ignored, that relates to the power of the 
remote modems. Ignored indicates that a power loss was 
detected, but the hardware monitor has ignored the indication 
because the addressed remote modem also responded with a 
valid status. A value of YES indicates the remote modem has 


. dropped power at least once since the last LPDA status report. 


On multipoint lines, any remote modem power loss will set 
this indicator to YES. 


For LDM, ‘ignored’ indicates that a power loss was detected, 
but hardware monitor has ignored the indication because the 
addressed remote LDM also responded with valid status. For 
example, on a multipoint link the power loss could occur for 
remote Lpm’s other than the one addressed by the link status 
(LS) command. ‘NO’ is the normal value. 


Indicates whether the adjacent modem of a modem pair has 
dropped power. If a power off time was received, the age of 
the last detected power off tone is displayed. If IGNORED is 
displayed, a power off tone was detected but the hardware 
monitor has determined that the power off tone received was 
not from the adjacent modem of the modem pair which was 
addressed in the MLS command. Range for POWER-OFF TONE iS 
YES or NO. Range for AGE is 1 second to 2 minutes, or is left 
blank. 


The name of the primary session partner's domain. This is 
the domain name of the session monitor that collected the 

primary session partner’s configuration data. The primary 
session partner’s domain name is displayed as X-NET if the 
primary session partner resides in a network different from 
that of the reporting session monitor. 


The element address of the primary session partner 
(hexadecimal). 


The name of the secondary session partner as known in the 
primary session partner’s network. 


Term 
*PRIMARY* NAME 


PRIMARY SA 
*PRIMARY* TYPE 
PROBABLE CAUSE 


PROD 


PRODUCT 


PRODUCT CLASSIFICA- 
TION 


PRODUCT DATA 


PRODUCT SET IDENTIFI- 
CATION DISPLAY 


PRODUCT- SPECIFIED 
MODIFIER 


PRODUCT UNIQUE TEXT 
PROGRAM PRODUCT 
NUMBER 


PT 


PROMPT 


PTF LEVEL OF SOFTWARE 


PU TYPE 


Component 


session 
monitor 


session 
monitor 


session 
monitor 


hardware 
monitor 


hardware 
monitor 


hardware 
monitor 


hardware 
monitor 


hardware 
monitor 


hardware 
monitor 


hardware 
monitor 


hardware 
monitor 


hardware 
monitor 


session 
monitor 


hardware 
monitor 


hardware 
monitor 


session 
monitor 


Definition 


The network name of the primary partner of an identified 


session. 


The subarea address of the primary session partner 


(hexadecimal). 


The resource type of the primary session partner. The type 


can be SSCP, PU, OR LU. 


Contains a summarized list of the most probable failing com- 


ponents. 


This appears alternatively with BLOCK ID for NMVTs and pre- 
cedes either a four-character machine type or a seven- or 
nine-character product number to identify a product that is 
not included in NMvT support for the user’s level of the hard- 
ware monitor. No third detail qualifier is displayed even if 
one was present in the original record. 


The count of the product check errors. These are usually 
caused by internal hardware errors. 


For hardware or software, it identifies the product as IBM or 
non-iBM, or indicates a failure to distinguish. 


This field contains the interrupt code and error indication 


area for machine checks. 


Information on the hardware or software that implements a 


network component. 


A unique product instance identifier. 


The variable length text data transmitted in the event record. 


The product number of the program. 


Displays a Trace Series panel for a Primary Trace. 


A list of selection options and special commands available 


from the current data display. 


Identification of software PTF level data as documented in the 


IBM product announcement documentation for BM products. 


The Pu Type is either 4 (NCP) or 5 (VTAM). 
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Term 
QUALIFIERS 


READ 


READ DCHK 


READ M-BYTES 


READ PERMS 


READ TEMPS 


READY FOR SEND DELAY 


REASON 


REASON CODE 


REC BYTES 


RECEIVE CONGESTION 
COUNTER 


RECEIVE LEVEL 


Component 


hardware 
monitor 


hardware 
monitor — 


hardware 
monitor 


hardware 
monitor 


hardware 
monitor 


hardware 
monitor 


hardware 
monitor 


session 
monitor 


session 
monitor 


4700 support 


facility 


hardware 
monitor 


hardware 
monitor 
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Definition 


Two to three lines of data from the product that generated the 
record. Multiple qualifiers can be displayed; a blank line is 
displayed if no qualifiers are sent by the product. Note: The 
meanings and uses of the qualifiers, if present, are described 
on the displayed panel. 


Contains statistical data associated with read operations: 


¢ DCHK contains the number of data checks that occurred 
during the read operations. 
¢ M-BYTES - Contains the number of megabytes read 


The number of data checks and check-data checks. 


The amount of data read, rounded down to the nearest mega- 
byte. 


The count of permanent read errors. 
The count of temporary read errors. 
See CLEAR TO SEND DELAY. 


The reason code in either hexadecimal or an English inter- 
pretation. 


The reason code associated with session termination 
(hexadecimal). The reason code is displayed below the 
session start time. 


For sessions that terminated because of a BIND failure, the 
reason code and its associated heading are not displayed if it 
is ‘00’x. For sessions that terminated because of UNBIND, the 
reason code and its associated heading are not displayed if it 
is ‘00’x, ‘01’x, or ‘02’x. For sessions that terminated because 
of failure BIND flow (INIT failure), the reason code and its asso- 
ciated heading are not displayed if it is ‘O0’x. 


For an extended statistical counter, the total number of bytes 
received from input devices during the indicated solicitation 
period. 


The count of transmissions not able to be copied by the local 
physical link station. 


Contains the value of the receive dBm level measurement if 
available. Displayed values range from -48 to -4 dBm for 
LPDA-1 test and -45 to 3 dBm for LPDA-2 test. The field could 
also contain N/A (not applicable), N/i (not installed), N/Av (not 
available), if the receive level function is not installed or is 
not supported in the configuration. 


Term 


REC LVL THRESH 
EXCEEDED 


RECEIVE PACKETS INTER- 
RUPTS 
RECEIVE PACKETS TOTAL 


RECEIVED 


RECEIVED 


RECEIVES TEMPS 


RECEIVES TRAFFIC 


REFRESH 


REINT 


RELEASE 


REMOTE DEVICE DLC 


ADDRESS 


REMOTE DTE 


REMOTE LDM 


REMOTE MODEM 


Component 


hardware 
monitor 


hardware 
monitor 


hardware 
monitor 


session 
monitor 


hardware 
monitor 


hardware 
monitor 


hardware 
monitor 


status 
monitor 


hardware 
monitor 


hardware 
monitor 


hardware 
monitor 


hardware 
monitor 


hardware 
monitor 


hardware 
monitor 


Definition 


Receive Level Threshold Exceeded. Indicates whether the 
receive level has exceeded the user-specified threshold in 
the last two minutes before the execution of the command. 


The count of interrupt packets received. 


The sum of information (i), receive ready (RR), and receive not 
ready (RNR) packets received. 


The sequence number of the last Pu that was received. 
Sample 2 always represents the last sample taken while 
sample 1 is the next to last sample taken. 


The number of times the SNA controller has received as SDLC 
TEST command with or without a valid frame check sequence 


(FCS). However, some controllers may count valid frames 
received only. Refer to the controller's component 
description manual for details. 


The count of temporary receive errors. 


Contains the following: 


e The count of all receive operations. 
e The count of all received frames. 


The Domain Status Summary display may be automatically 
refreshed periodically by pressing PF9. 


This field will be highlighted (white) if automatic refresh is on. 
When this feature is on, the screen will be updated automat- 


ically every minute. In addition, it will be updated automat- 
ically when any of the totals are changed. To switch 
automatic refresh off, press PF9. 


A ‘yes’ or ‘no’ value indicating whether modem initialization 


has occurred within the last two minutes. The modem rein- 


itialization occurs when the modem is powered on, when it is 


reset on a hard or soft error, or by a change to a modem 


setup switch. 


The release level of the program. 


The Data Link Control address of the remote link component. 


The DTE that attaches to the remote LDM. 


Identifies the remote LDM machine type. : 


The modem that receives LPDA-2 commands from its line 


interface, not its DTE interface. These commands have previ- 


ously been intercepted and retransmitted by the local 


modem. 
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Term 


REMOTE MODEM 
ADDRESS | 


REMOTE MODEM 
SELF-TEST 


REMOTE OPERATION 
TEST 


REMOTE STATION DLC 
ADDRESS 


REMOTE STATION LAN 
ADDRESS 


REMOTE STATION SNA 
NAME 
REQ PARMS 


REQ/RESP HEADER 


RER 


RESNAME 


RESOURCE 


Component 


hardware 
monitor 


hardware 
monitor 


hardware . 
monitor 


hardware 
monitor 


hardware 
monitor 


hardware 
monitor 


4700 support 
facility 
session 
monitor 


session 
monitor 


hardware 


monitor 


session 
monitor 


B-28 NetView Operation 


Definition 


Actual modem address as reported by the remote modem. 


The heading is displayed when the record received indicates 
that the test was not executed, or that there was no response 
or a bad response. No other modem status will appear on 
the screen if this line appears. 


Contains a passed/failed indicator for the remote LDM opera- 
tion test. 


The DLC address of the remote SDLC station. 

The LAN address of the remote SDLC station. 

The SNA name of the remote SDLC station. 

Parameters required in addition to the selection number. 


The EBCibDIC interpretation of the bit settings in the 
request/response header (Rk). 


The number of the reverse explicit route used by the session. 


The notation N/A may appear instead of the RER number. This 
means the network of the operator making the request is not 
authorized to view the specific configuration data of the 
network displayed, or the numbers were not supplied by VTAM 
in session awareness data. 


The name of the failing resource, or, when an * appears after 
the resname, the resource to which the failing resource is 
attached or the first SNA device to which the failing resource 
is attached. 


The network name of the resource. 


Term Component Definition 


RESOURCE EVENTS hardware These subheadings refer to events logged against resources 


monitor named in the RESOURCE column: 


FROM - The date and time associated with the oldest event 


record received since the data base was initialized or 
since records for this resource were purged. 


RESNAME - The resource name or the failing resource 
name associated with the event or statistical data. When 
an asterisk (*) appears before the RESNAME, it is the 
resource to which the failing resource is attached. 


TO - The date and time associated with the most recent 
event record for this resource. 


TOTAL - The total number or event records hardware 
monitor has recorded in its data base for this resource 
since data base initialization or since the last purge for 
this resource. 


TYPE - The resource type associated with the alert. Some 
common resource types are as follows: 


— CHAN - Selector, byte/block-multiplexor, or integrated — 


channel 

— COMC - Communication controller or transmission 
control unit 

— cpu - Central processing unit of the network host 
system 

— CTRL - Link-attached cluster controller 

— DEV - Link-attached device or terminal 

— 1ocu - Channel-attached I/O control unit for 3800 
printer 

— LCTL - Channel-attached controller (communications 
and cluster) 

— LDEv - Channel-attached terminal 

— LINE - Link attachment between the communication 
controller and the cluster controller or between com- 
munications controllers 

— SCU-DASD storage control unit of the network host 
system 

— TCU - Tape control unit of the network host system. 


RESOURCE TYPE session The physical unit, logical unit, or pre-SNA device that is the 
monitor secondary session partner. 
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Term 
RESP TIME DATA 


RETURN 


RH 


RING NUMBER 


RLSD LOSSES (Receive 
Line Signal Detect) 


RLSD LOSSES, AGE 


RLSD (RECEIVE LINE 
SIGNAL DETECT) SENSI- 
TIVITY 


RLSD STATE 


ROUTING INFORMATION 


Component 


4700 support 
facility 


hardware 
monitor 


session 
monitor 


hardware 
monitor 


hardware 
monitor 


hardware 
monitor 


hardware 
monitor — 


hardware 
monitor 


hardware 
monitor 


B-30 NetView Operation 


Definition 
Response time data as follows: 


e AVG - The average response time recorded for this 
resource (WS or CTRL) during the last solicitation period 
(expressed in seconds). 


® COUNT - The number of response time measurements 
made for this resource (CTRL or ws) during the last solic- 
itation period. 


¢ NAME - The name assigned by the user to the interval 
timer associated with the response time data that follows 
on the same line. 


A presentation of the previous Data display or the Main Menu 
display. 


The HEX representation of the Request or Response Header. 
The ring or segment identifier. 


The number of carrier detect losses which were detected 
during the last 15 minutes before the LA or unsolicited MLS 
command was executed. On the Link Problem Determination 
Aid panels, either ‘N/A’ or ‘NO’ may be shown for the Local 
Modem when the configuration is multipoint. This is due to 
the fact that these displays analyze both permanent error and 
statistical records. The permanent error records that contain 
long link status data have the configuration present. From 
this, hardware monitor can determine that the local modem is 
in a multipoint configuration and thus show ‘N/A’ for RLSD. The 
statistical records do not have the configuration data, so 
hardware monitor reads the state of the ‘lost RLSD’ bit and 
shows ‘NO’ on the display. 


The term CARRIER DETECT LOST (CDLST) is equivalent to RLSD. 


Contains the number of carrier detect losses detected during 
the the last 15 minutes and the age of the last RLSD loss. 
Range for the number of RLSD losses is 0 to 255. Range for 
AGE is 1 second to 2 minutes or more, or is left blank. 


The carrier detect sensitivity expressed as normal or limited. 
The options (NORMAL Or LIMITED) can be selected with a switch 
on the rear panel of the modem. For 386x, the LIMITED position 
is not often used. Value is always ‘normal’ for 586x modems. 


Receive Line Signal Detect (RLSD) indicates whether the local 
modem received a signal from the remote modem when the 
command was issued. Range for the local modem is ON or 
OFF. RLSD is not applicable to the remote modem. 


The LAN routing information used by a link connection. 


Term 
RT 


RU 


RU DATA 


RULEN 


SA 


SA, EL 


SCREEN CONTROL 


SCS 


SECONDARY KNOWS 


PRIMARY BY ALIAS 


SECONDARY CON- 
TROLLER SDLC LINK 
TEST COUNTS 


*“SECONDARY* DOM 


SECONDARY EL 


*SECONDARY* NAME 


SECONDARY SA 


*"SECONDARY* TYPE 


Component 


session 
monitor 


session 
monitor 


session 
monitor 


session 
monitor 


session 
monitor 


session 
monitor 


hardware 


monitor 


hardware 


monitor 


session 
monitor 


hardware 


monitor 


session 
monitor 


session 
monitor 


session 
monitor 


session 
monitor 


session 
monitor 


Definition 


Displays the Session Response Time panel. 


The HEX representation of the Request Unit. To view the 
request unit, enter SEL# for the line desired. 


The request unit in hexadecimal and EBCDIC representations 


The length (bytes) of the request unit, as taken from the trans- 
mission header (Th). 


The subarea address of the named SSCP. 
The subarea and element address of the PLU and SLU. 


A list of the screen control commands and a brief explanation 
of each. 


The sub-channel status byte from the csw (channel status 
word). It is expressed as two hexadecimal characters. 


The name of the primary session partner as known in the sec- 
ondary session partner’s network. 


Information can be as follows: 


® RECEIVED - The count of the number of times the SNA con- 
troller has received an SDLC TEST command with or 
without a valid frame check sequence (FCs). 


© TRANSMITTED - The count of the number of times the SNA 
controller has received an SDLC TEST command with a 
valid FCS and has transmitted a response to that 
command. 


The name of the secondary session partner’s domain. This is 
the domain name of the session monitor that collected the 
secondary session partner’s configuration data. The sec- 
ondary session partner’s domain name is displayed as X-NET 
if the secondary session partner resides in a network dif- 
ferent from that of the reporting session monitor. 


The element address of the secondary session partner 
(hexadecimal). 


The network name of the secondary session partner. 


The subarea address of the secondary session partner 
(hexadecimal). 


The resource type of the secondary session partner. This 
type can be SSCP, PU, OR LU. 
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Term Component 


SEEKS K-COUNT hardware 
monitor 
SEEKS SKCHK hardware 
monitor 
SEL# session 
monitor 
SEL# hardware 
monitor 


B-32 NetView Operation 


Definition 


The count of seek commands executed, shown in thousands. 


The count of seek checks associated with the count of seek 
commands. | 


The selection number that allows you to proceed further into 
the session monitor panel sequence. 


You can enter the selection number of another session 
monitor panel to transfer over to that panei, or you can enter 
the selection number and CT to invoke the connectivity test for 
an active session involving a resource that is not locally 
attached. For panels in the Help series, the selection number 
allows you to proceed to a more detailed command 
description for a specific command. 


® SEL#CT - Issues a connectivity test for the selected 
session. 

¢ sSEL#ER - Displays the Explicit Route Configuration panel. 

® SEL#RTS - Displays the Response Time Summary panel. 

e SEL# RTT - Displays the Response Time Trend panel. 

® SEL#STR - Session Termination Reason panei. 

® SEL# VR - Displays the Virtuai Status panel. 


The selection number which, when entered on the command 
line, provides the operator with the following display or func- 
tion related to the selected alert: 


@ SEL# - The Recommended Action display for the alert is 
presented. 


® SEL#C - the hardware monitor code representing the alert 
“alert description”: probable cause is displayed on the 
nardware monitor message line. 


® SEL# DEL - the selected alert is deleted from the data base. 


* SEL#™M - The Most-Recent Events display for the resource 
associated with the alert is presented. 


e SEL#P - alert information is entered in the 
Information/Management data base. 


¢ SEL#P id - alert information is entered in the specified (id) 
Information/Management data base record. The ‘id’ field 
is a five-character record number assigned by 
Information/Management. 


¢ SEL# SRF - for the resource to which the alert pertains, it 
creates on entry in the alert recording filter to block 
future recording of alerts. 


® SEL# SRF ALL - for any resource, it creates an entry in the 
alert recording filter to block future recording of all alerts. 


Term 
SEL# 


SELECT ENTRY 


SELF TEST 


SENS 


SENSE 


SENSE 


SENSE DATA 


SENT 


SEQ# (REF#) 


Component 


4700 support 
facility 
4700 support 
facility 


hardware 
monitor 


session 
monitor 


session 
monitor 


hardware 
monitor 


session 
monitor 


session 
monitor 


session 
monitor 


Definition 


The selection number that allows the network operator to 
proceed further into the display sequence. 


The displays that may be selected. 
Contains a PASSED or FAILED indicator for the test. 
The SNA code for any negative responses. 


The sense code associated with session termination 
(hexadecimal). The sense code is displayed below the 
session end time. The sense code and its associated 
heading are not displayed if the sense code is ‘OOQ00000'x. 


Contains data extracted from the sense field of the OBR record 
(up to 48 hexadecimal characters, depending on the device 
type): 


e For DASD devices it is the 2-byte fault symptom code. 

e For local communication and tape devices it contains the 
complete sense field. 

e For 3800 printers it is the status code. 


The following values appear by this field: 


© BYTE 2- The hexadecimal vaiue of BYTE 2. 

e BYTE3 - The hexadecimal value of BYTE 3. 

© CATEGORY - The hexadecimal value of CATEGORY. 
¢ MODIFIER - The hexadecimal value of MODIFIER. 


Explanations in English for the values of CATEGORY, MODIFIER, 
BYTE2, and BYTES follow the hexadecimal values. For more 
discussion of sense data, see SNA Reference Summary. 


The sequence number of the last piu that was sent by the vr 
endpoint PU. Sample 2 always represents the last sample 
taken while sample 1 is the next to last sample taken. 


The last (maximum of four) Plu sequence numbers passed to 
session monitor from ncpP for the specified NCP sessions. 


They are the sequence numbers of the last two Pius outbound 
and inbound for the ncP. The first sequence number dis- 
played is the most recent outbound sequence number. The 
third sequence number is the most recent inbound. Fora 
pre-SNA device, this field is a 1-byte reference number (REF#) 
for the three most recent outbound and the most recent 
inbound Pius (rightmost). The sequence numbers will not 
necessarily be in numerical order, but rather in the order in 
which they were sent from NcP. See ACF/ncP Diagnosis Guide 
for details. 
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Term 
SEQUENCE NUMBER 


SER# 

SERVICEABLE COMPO- 
NENT IDENTIFIER LEVEL 
SESSION DOMAIN 

SG 

SIGNAL TO NOISE RATIO 


SNA NEG-RESPONSE 


SNBU 


SNBU, TYPE OF CON- 
NECTION 


SPECIFIC 


SPEED 


SPEED CONTROL MODE 


SSCP 


SSCP ID 


SSCP PU TYPE 


Component 


hardware 
monitor 


hardware 
monitor 


hardware 
monitor 


hardware 
monitor 


session 
monitor 


hardware 
monitor 


hardware 
monitor 


hardware 
monitor 


HARDWARE 
MONITOR 


hardware 
monitor 


hardware 
monitor 


command 
facility 


session 
monitor 


session 
monitor 


session 
monitor 


B-34 NetView Operation 


Definition 


The sequence number of the machine originating the data 
record. | 


The six-character Cpu serial number. 


The component identification of a serviceable component, as 
assigned by service personnel. 


The domain name associated with the data you are viewing. 


Displays a Trace Series panel for a Secondary Gateway 
Trace. 


The separation of noise power level and the received signal 
level seen by a modem. 


The count of the number of times the identified unit originated 
an SNA negative response for the identified event. 


The switched network backup values are YES or NO. A YES 
indicates that the modem has switched the primary line that 
is unavailable or unusable to an alternate backup line. This 
line on the panel will not be displayed if the SNBU feature is 
not installed. 


indicates if Switched Network BackUp is active (YES or NO) 
and what type of connection (2 WIRE or 4 WIRE) if SNBU is active. 


This indicates the type of component, sub-component, or 
logical resource that can be most closely related to the 
exception condition (event). 


The transmit speed of the modem in kilobits per second 
(KBPS). A value of ‘? KBPS’ indicates that the reported speed 
is invalid. 


indicates whether the line is operating in FULL or BACKUP 
speed. 


Can be set either by the modem or the pte. The possible set- 
tings for speed control mode are: 


D - The data terminal equipment sets the mode 
M - A modem command sets the mode. 


The name of the sscP associated with the named domain, 
which supplies the name of the subarea node. For migration 
hosts, this is the access method name. 


Hexadecimal value of the id of the sscP that issued the ACTPU 
or ACTCDRM for the Session Parameters panels. 


Pu type of the node containing the sscp must be 5. 


Term 
ST 


START TIME 


STAT 


STAT TYPE 


STATUS 


STATUS 


Component 


session 
monitor 


session 
monitor 


session 
monitor 


hardware 
monitor 


session 
monitor 


hardware 
monitor 


Definition 


Displays a Trace Series panel for a Secondary Trace. 


The date and time the session was started in month/day 
hour:minute:second format. 


The status of the conversation between this session monitor 
and the session monitor in the named domain. The status 
values are: 


e ALLOC - Allocated 

® DEALL - Deallocated 

¢ NEVAL - Never allocated 

® PNDAL - Pending allocation 

® PNDDE - Pending deallocation 


Indicates why the statistical record was generated. These 
values apply only to statistical records generated by NcP 
Version 3 and Version 4 plus any subsets. N/A is displayed for 
all other records. The codes used are: 


¢ pACcT - Deactivation in progress 

¢ PERM - Permanent Error 

¢ TEMP - Receive Congestion Counter Reached Threshold 
or Temporary Error Count Threshold Reached 

¢ tTemp-i - Total Retries Threshold Limit Reached 

¢ TEMP-2 - Receive I-Format Error Threshold Reached 

e TEmP-3 - Total I-Format Re-transmission Threshold 
Reached 

e TRAF - Traffic Count Threshold Reached. 

¢ TRAF-1 - Total Transmission Threshold Exceeded 

¢ TRAF-2 - Transmission Threshold Exceeded (l-Format) 

¢ TRAF-3 - S Format Received Threshold Exceeded 

¢ TRAF-4 - Total Acknowledged I-Format Threshold 
Exceeded 

® TRAF-5 - |-Format Error Free Received Threshold 
Exceeded 

¢ TRAF-6 - Total Received (l-Format Error-Free Error) 
Threshold Reached 


The type of data available for the network named. ACTIVE indi- 
cates that the session monitor is aware of an active session 
with this resource. HISTORY indicates that the session monitor 
has no active information about this resource, but that histor- 
ical data is available. 


Contains the status code (two hexadecimal characters of 
status data) found in the event record. Values are described 
in the /BM 3270 Information Display System Component 
Description. 
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Term 
STATUS 


STATUS CODE 


STATUS SINCE 


STATUS TOTALS 


STREAMING 


SUBAREA1 


SUBAREA2 


SUBAREA PU 


SUSPECTED CARD 


SYMPTOM CODE 


SYNTAX 


TEMPS 


TEST MODE 


Component 


4700 support 
facility 


status 
monitor 


status 
monitor 


status 
monitor 


hardware 
monitor 


session 
monitor 


session 
monitor 


session 
monitor 


hardware 
monitor 


hardware 
monitor 


session 
monitor 


hardware 
monitor 


hardware 
monitor 
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Definition 


Status indicator (OPT = operative, INOP = inoperative). 


One character status code indicating the current status of the 
node (as known to vTAM). Possible values are: 


e A-ACTIVE status, excluding ACT/U 

e |-INACTIVE status 

¢ N-NEVACT Status (never yet activated) 

¢ O- OTHER status (any VTAM Status other than the above). 
¢ P- PENDING status (any of the VTAM pending statuses) | 


The time of day the node assumed its current status. 


The totals on the bottom row are vertical totals by type of 
status. | 


The values are YES (RTS FAILED TO TURN OFF) or NO. Streaming 
is an error condition in which a station on a multipoint link or 
fanout configuration goes into continuous transmit mode for 
more than 40 seconds and prevents other stations on that link 
from transmitting. This condition is not detected by a 
tributary modem unless a rear panel switch on the modem 
(S1-7) is set to enable ANTI-STREAMING. 


The address of the origin subarea of the explicit route. In 
panel NLDM.TG it is the originating subarea of the Ta. 


The address of the destination subarea of the explicit route. 
In panel NLDM.TG it is the terminating subarea of the Ta. 


The primary (left) and secondary (right) resource subarea’s 
physical unit services (an NCP Or a HOST). The subarea 
network name and element, xxxxxxxx(hhhh), are shown next 
to the configuration box. 


This contains the type of field-replaceable unit in error, if any. 


_ Types include feature card, PMAU, PMAU-E, and FRONT END. If 


TEST RESULTS equals PASSED, this entry will not be displayed. If 
TEST RESULTS equals FAILED and no card is identified, the word 
UNDETERMINED is displayed following the heading. 


Four hexadecimal characters of sense data (bytes 22 and 23) 
from the temporary OBR record that describes the condition 
that caused the record to be generated. 


The proper syntax of the commands in the Help series 
panels. 


A count of all temporary errors. 


Indicates whether the command was initiated by an operator 
(SOLICITED) or by the controlling node (UNSOLICITED). 


Term 
TG 


TH 


TGN 


THRESH 


THRESHOLDS 


TIME 


TIME 


TIMER 


TO 


Component 


session 
monitor 


session 
monitor 


session 
monitor 


4700 support 
facility 


command 
facility 


session 
monitor 


hardware 
monitor 


4700 support 
facility 


hardware 
monitor 


Definition 


The number of the transmission group connecting two sub- 
areas in the path of the explicit route. 


The HEX representation of the Transmission Header. 


On the Specific NLDM.TG Configuration panel, the number of 
the selected transmission group. 


The error counter threshold value in effect at the time of 
solicitation. The Loop Basic Counter 2 threshold is 
expressed as a noise count rate, noise count per hour. The 
extended statistical counter threshold is expressed as a per- 
centage of error bytes. 


The modems monitor permanently some line parameters: 


e Receive Level Threshold. Specify a threshold for the 
amplitude of the received signal above which a warning 
signal will be reported. The setting range is between 00 
and -43. 


e Impulse Hits Threshold. (Impulse Noise) Specify the 
threshold above which a warning indication will be 
reported. The setting range is between 00 through 63. 


e Line Quality Threshold. A modem calculated running 
average ranging from 0 to 14 that shows the quality of 
signal received by the modem. A value in the range 0 to 
4 is considered “good”, the range of 5 to 9 considered 
indeterminate and the range 10 to 14 is considered 
“bad”. 


A time stamp provided by the access method at the time the 
PIU was traced. 


The value specified in hours and minutes. This indicates that 


the filter element applies to any resource that has had recent 
activity, either directly (for event or statistical data) or indi- 
rectly via an attached resource (for event data). There is 
recent activity if data has been received and recorded within 
the last HH hours and Mm minutes before viewing a total 
display. 


The name assigned by the user to the interval timer associ- 
ated with the response time data that follows on the same 
line. The name may change from solicitation to solicitation 
as the network operator has the ability (using the SET 
command) to change the active 3600/4700 interval timer on a 
workstation basis. 


The date and time associated with the latest event or statis- 
tical record (as appropriate to the display). 
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Term Component 


Definition 


This field displays FAILED if the test failed, or the entire line 
will be blank if the status indicated passed. NOT SUPPORTED 
indicates that the TAc (Test Alarm Card) feature is not 
installed. 


TONE TEST | ; hardware 
monitor 

TOTALS hardware 
monitor 


B-38 NetView Operation 


The statistical data associated with the identified resource. 
Fields that are totaled include: 


E/T - A calculated ratio of the recoverable error countto 
the traffic count expressed as a percentage. This applies 
to channel attached communication control units and 
attached devices (except local controllers under vTAM), 
and link attached control units. Otherwise, the field will 
be marked N/A. 


FROM - The date and time associated with the oldest sta- 
tistical record on the data base. For LINES, a N/A is dis- 
played. 


TEMPS - Contains a total count of all recoverable errors. 
For those devices not supported the field is marked N/A. 
TEMPS for SDLC does not include temporary errors caused 
by polling. 


To - The date and time associated with the most current 


statistical record: 


— For level 1 with TYPE COMc, the date of the most 
current level-2 or level-3 statistical record with a type 
of LINE at level-2. For communication controllers at 
level-1, it is the date of the most recent statistical 
record received for any of the stations on the lines 
attached to that communication controller. 


— For level-4 or level-2 with TYPE LINE, the date of the 
most current level-5 statistical record with a type of 
CTRL at level-5. For lines at level 2 or 4, it is the date 

_ of the most recent statistical record received for any 
station on that line. 


— Aratio of the recoverable error count to the traffic 
count expressed as a percentage that is calculated 
daily from the records received since 00:00 (mid- 
night). This applies to channel attached communi- 
cation control units and attached devices (except 
local controllers under VTAM), and link attached 
control units. Otherwise, the field will be marked N/A. 


TRAFFIC - A total count of traffic for the specified resource: 


— For channel attached communication devices it is the 
count of SIOS. 


— For s/s and BSC stations, it is the count of the number 
of blocks transmitted. 


Term 


TOTALS (cont.) 


TOTAL ERRS 


TOTAL KSIO 


TOTAL TEMPS 


Component 


hardware 
monitor 


hardware 


monitor 


hardware 
monitor 


hardware 
monitor 


Definition 


— For SDLC stations, it is a count of all transmit and 
receive operations. It does not include polling oper- 
ations. Traffic counts reported by an ncpP for devices 


downstream from a 3710 are reported as if the station 


was attached to an SDLC line. For traffic counts 


received from 3710 for its downstream stations, hard- 


ware monitor will sum the transmit data counter, the 
poll counter and receive data counter. 


— For lines at level 2 or 4 of the hardware monitor hier- 
archy, it is the sum of counts for all attached stations. 


Statistics are only maintained for lines at hierarchy 
level 2 or 4. 


— For storage, it is stated in megabytes of data read. 
— For tape, it is a count of sios, stated in thousands. 


— For unit record, traffic is applicable for 3800 printing 
sub-system only, where it is measured in thousands 
of feet of paper processed. 


— For communication controllers attached to X.25 
virtual links, traffic is the sum of |, RR, and RNR 
packets transmitted and received. 


— For communication controllers attached to X.25 phys- 


ical links, traffic is the sum of !, RR, RNR, and REJ 
frames transmitted and received. 


— Traffic count is not applicable for cpu, channel, and 
control units in network host processor hierarchy or 
in communication controllers and lines at other than 
level 2 in the network hierarchy. The field is marked 
(N/A). 


The number of times a communication check error occurred. 


The count of sios (rounded down to the nearest thousand). 


Contains the following: 


e The count of all temporary errors. For SDLC stations, this 


field may be larger than the sum of receive errors and 

transmission errors. This is usually because poll time- 
outs (non-response to polls) are included in the total or 
transmission errors fields. 


e The count of all temporary errors, including bus-out 
parity checks, equipment checks, overruns, seek checks, 
and data checks. 


e The count of all temporary read and write errors. 


e The count of transmit and receive temporary errors. 
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Term 
TOTAL TRAFFIC 


TP 


TRACE 


TRAINING SEQUENCE 


TRANSMISSION PACKETS 
INTERRUPTS 


TRANSMISSION PACKETS 
TOTAL 


TRANSMISSION TEMPS 


TRANSMISSIONS TRAFFIC 


Component 


hardware 
monitor 


session 
monitor 


session 
monitor 


command 
facility 


hardware 
monitor 


hardware 
monitor 


hardware 
monitor 


hardware 
monitor 
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Definition 
Contains the following: 


¢ The count of all transmit and receive operations for SDLC 
stations, a count of the blocks transmitted for BSc and S/s 
stations, or a count of sios for channel attached communi- 
cation devices. 


e The amount of paper processed, shown in thousands of 
feet. 


e The count of all frames transmitted and received. 


¢ The sum of RECEIVE PACKETS TOTAL and TRANSMISSION 
PACKETS TOTAL. 


The transmission priority field for the virtual route. The nota- 
tion N/A may appear instead of the TP number. This means 
the network of the operator making the request is not author- 
ized to view the specific configuration data of the network dis- 
played, or the numbers were not supplied by VTAM in session 
awareness data. 


The trace setting for the specified resource; either ON or OFF. 


A predefined bit pattern that modems exchange when they 
need to get synchronized. This occurs on point to point links 
after a loss of signal, and on multipoint link every time a 
tributary modem starts sending data. The possible settings 
for training sequences are: 


L - Long training sequence 
S - Short training sequence. 


The count of interrupt packets transmitted. 


The sum of information (1), receive ready (RR), and receive not 
ready (RNR) packets transmitted. 


Contains the following: 


e The count of temporary transmission errors. Note: For 
SDLC stations and for stations attached to a network con- 
troller. N/A is displayed for all other resources. 

e The count of retransmitted frames. 


Contains the following: 


e The count of all transmit operations. Note: For SDLC 
stations and for stations attached to a network controller. 
N/A is displayed for all other resources. 

e The count of all transmitted frames (1, RR, RNR, AND REJ). 


Term 


TRANSMIT CLOCK 
OPTION 


TRANSMIT LEVEL 
TRANSMIT RECEIVE TEST 
(TRT) 


TRANSMITS NOT COPIED 


TRANSMITTED 


TS PROFILE 


TYPE 


TYPE 


TYPE 


Component 


command 
facility 


hardware 
monitor 


hardware 
monitor 


hardware 
monitor 


hardware 
monitor 


session 
monitor 


session 
monitor 


session 
monitor 


hardware 
monitor 


4700 support 
facility 


Definition 
Defines what clock controls the internal clock of the modem. 
The possible settings are: 


Internal - The modem uses the modem internal clock 
External - The modem uses the external clock of the DTE 
Receive - The local transmit clock is locked to receive 
clock. 


The value of the transmit dBm level measurement. Field can 
contain N/A or N/AV. 


Test in which the modems exchange pre-defined bit patterns 


over the line and report the results that the modems detected. 


The count of transmissions not able to be copied by the 
remote SDLC link station. 


The number of times the SNA controller has received the SDLC 
TEST Command with a valid FCs and has transmitted a 
response to that command. 


Transmission Subsystem Profile; may be 1 through 5, 7, or 17. 


Type of command (x/y) where x can be: 


e Immediate 
e Delay 


and y can be: 


e Append 
e Ignore. 


For the Session Termination Reason panel, it is the session 
termination type. It can be BIND, UNBIND, or INIT Failure. 


For the Session Trace Data for PiU panel, it is the type of RU in 
the Plu (positive response, negative response command or 
data). 


For the Session Parameters panels, the interpretation can be 
either REQ (request) or RSP (response). For BSc attached 
resources, this field contains an abbreviation of the BTU com- 
mands. (See ncP and Ep Reference Summary and Data Areas 
for more information on BTU commands.) If “* NOTE” is dis- 
played, the data is device-dependent and you should refer to 
the appropriate device documentation for a command defi- 
nition. For example, if the device is NCP, see NCP and EP Ref- 
erence Summary and Data Areas. 


Represents the device type associated with the failing 
resource or a 4-character modem type. 


The type of 3600/4700 controller. 
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Term Component 
TYPE OF COMM.ERRORS = hardware 
monitor 
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Definition 


Identifies each of the communication check error types that 
the user may select. The counter for each of these individual 
communication error types has a maximum value of 255; 
therefore, the sum of the individual counters may be less 
than the value shown in the ERRORS-COMMUNICATION field. The 
types of errors are: 


COMM ADAPTER MACHINE CHECK — Non-recoverable machine 
checks were caused by the communication adapter. 


CONNECTION PROBLEM - The connection command retry 
count has been exceeded. 


DCE ERROR - Data communication equipment (DCE) drops 
ready or some other interruption has occurred. 


FCS ERROR - Invalid frame check sequences (FCS) were 
received. 


IDLE TIMEOUT - No SDLC framing characters have been 
received within a time interval specified by the communi- 
cations adapter. 


INVALID STATUS - The status generated by the communi- 
cation adapter is meaningless because of a hardware 
failure. 


NON-PRODUCTIVE TIMEOUT - No valid SDLC frames have been 
received within a specified time interval. 


OVERUN - The number of times received characters have 
been overlaid. 


PRIMARY STATION ABORT - Eight or more consecutive 1 bits 
were received. 


RECEIVED HPCA (High Performance Communications 
Adapter) OVERRUN — The line is “hung”, or insufficient 
buffer space has been allocated. 


SDLC COMMAND REJECT - An SDLC command was rejected 
because it was invalid, had data without a command, or 
had a sequence count error. 


UNDERRUN - The number of times characters have been 
retransmitted erroneously. 


WRITE RETRY - SDLC I-frame re-transmissions were caused 
by the failure of the primary station to acknowledge the 
sequence number. 


WRITE TIMEOUT - Write failures occurred because of a clock 
malfunction or a missing clear to send (CTS). 


Term Component Definition 


TYPE OF COMM.ERRORS hardware ~ The number of times the following conditions have been 
monitor detected by the controller: 


CA BUS OUT PARITY-SELECT - The control unit channel 
adapter detected an equivalence error from the channel 
during a selection sequence. 


CA BUS OUT PARITY-WRITE - The control unit channel adapter 
detected an equivalence error from the channel during a 
write operation. 


CA INTERNAL PARITY-READ - The control unit channel adapter 
detected that it had transmitted bad parity on the channel 
bus-in during a read operation. 


COMMAND REJECT - The control unit channel adapter — 
received a command that was invalid or was not sup- 
ported. 


CONNECT PARAMETER ERROR - The connect was rejected 
because it specified an odd buffer length, or it specified 
an insufficient buffer size. 


CONNECT RECEIVED - A connect request was received when 
the control unit was already connected. 


CU INTERNAL PARITY-READ - The control unit detected an 
internal equivalence error during a read operation. 


CU INTERNAL PARITY-WRITE - The control unit detected an 
internal equivalence error during a write operation. 


DATA CHECK - The host’s read command was not large 
enough to transfer all data from the control unit’s buffer. 


DATA LENGTH CHECK RECEIVED - The number of data bytes 
received from the channel does not match the data count 
field or was fewer than 4. 


DATA LENGTH CHECK RU - The primary physical unit has sent 
a larger request/response unit (RU) than the secondary 
physical unit can accept. 


DISCONNECT RECEIVED - A disconnect request was received 
when the PU was active. 


INCORRECT SEQUENCE - An incorrect READ START 0/1 Sequence 
has been issued by the host. 


INTERNAL PARITY-CYCLE STEAL the control unit channel 
adapter detected an error during an internal channel 
adapter cycle-steal operation. 


NOT INITIALIZED-CONTROL - An initial control command con- 
taining a valid connect order was not received. 


NOT INITIALIZED-SENSE - A sense command was received 
when the control unit was no longer initialized. 
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Term 
TYPE OF COUNTER 


US 


USER CAUSED 


VALUE 


VERSION 


VOLSER 


VR 


VR POOL CURRENT 


VR POOL LIMIT 


VR STATUS 


WINDOW SIZE CUR 


WINDOW SIZE MAX 


WINDOW SIZE MIN 


WRITE M-BYTES 


Component 


hardware 
monitor 


hardware 
monitor 


hardware 
monitor 


hardware 
monitor 


hardware 
monitor 


hardware 
monitor 


session 
monitor 


session 
monitor 


session 
monitor 


session 
monitor 


session 
monitor 


session 
monitor 


session 
monitor 


hardware 
monitor 
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Definition 


Contains a listing of the counters found in the input record. 
Abbreviations are: 


e psit - Delivery bit 

e 1- Information 

e REJ - Reject 

® RNR - Receive not ready 
e RR -Receive ready. 


The unit status byte (4 byte) from the channel status word 
(CSW). It is two hexadecimal characters. 


A list of conditions for the problem which are the result of a 
user action. 


This lists the value for each counter. N/A is displayed if it is 
not supported or is invalid. 


The version of the program. 


The volume serial number of the disk or reel associated with 
the input record. 


The number of the virtual route used by the session. The 
notation N/A may appear instead of the vR number. This 
means the network of the operator making the request is not 
authorized to view the specific configuration data of the 
network displayed, or the numbers were not supplied by VTAM 
in session awareness data. 


The current count of inbound PiUs over the vR. The vr pool 
current value is displayed for PU type 4 (NCP) end points only. 


The threshold of inbound pius allowed over the vr. The vr 
pool threshold is displayed for Pu type 4 (NCP) end points only. 


Based on analyses of the last two samples using “A” 
(ANALYZE VIRTUAL ROUTE CONDITION) on the vr Status Panel, this 
field describes the status of a virtual route you have specified 
for testing. The conclusions, which appear on lines 10 and 19 
of the panel, are not displayed if only one sample has been 
taken. (See SENT and RECEIVED). See Appendix C for a list of 
status conclusions with explanations. 


The current vR pacing window size. 
The maximum vr pacing window size. 


The minimum vr pacing window size. 


The amount of data written, truncated to megabytes. 


Term 
WRITE PERMS 


The count of permanent write errors. 


WRITE TEMPS 


WSNAME 


The name (WSNN) of the selected workstation. 


XRF 


YOUR DOMAIN 


Component 


hardware 
monitor 


hardware 
monitor 


4700 support 
facility 


session 
monitor 


hardware 
monitor 


Definition 


The count of temporary write errors. 


This stands for the extended recovery facility session type. | 


The possible extended recovery facility session types are 
PRIMARY and BACKUP. This field and its associated heading 
are not displayed if the session is not an extended recovery 
facility session. 


The name of the domain to which your terminal is attached. 
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Appendix C. Virtual Route Status Conclusions 


This information is provided to give you a basis to judge fields on the session 
monitor Virtual Route Status panel. In this panel, as with all judgmental panels, 
good or normal information is green, marginal or warning information is yellow, 
and bad or error information is red. 


The messages below can be found on lines 10 through 19 of the Virtual Route 
Status panel. An explanation for each message follows the message: 


VR IS NOT BLOCKED 
The virtual route is operating normally and no blockage is detected. 
This does not mean that the virtual route is never entering the blocked 
state. It only means that at the times of both samples the virtual route 
was not blocked. 


TRANSIENT VR BLOCK 
One of the two samples indicates that the sender is waiting for a virtual 
route pacing response (VRPRS) and data has been sent over the virtual 
route during the time between the two samples. 


This is a transient condition; however, if nothing appears to be flowing 
over the virtual route after repeated analysis requests, there may be a 
problem in the origin node itself or with the first transmission group in 
the explicit route. 


TRANSIENT VR BLOCK - AWAITING VRPRS 
One of the two samples indicated that the sender is waiting for a virtual 
route pacing response and neither sample indicated that the receiving 
NCP was withholding a virtual route pacing response. 


This is most likely a transient condition. If the condition occurs repeat- 
edly, check the virtual route pacing window size. If it is at the 
maximum, you should consider increasing it. If itis at the minimum, 
some node along the explicit route may be congested; use Network Per- 
formance Monitor NPM to investigate this possibility. 


TRANSIENT VR BLOCK - DEST. CONGESTED 
One of the two samples indicated that NcP is withholding a virtual route 
pacing response due to a slowdown condition. 


This is a transient condition that most likely will go away on its own. If 
the condition occurs repeatedly, the system programmer may want to 
tune the network so that the NcP does not go into slowdown so often. 


TRANSIENT VR BLOCK - NO DATA SENT 
One of the two samples indicates that the sender is waiting for a virtual 
route pacing response and that no data has been sent during the time 
between the two samples. 


This is a transient condition; however, if nothing appears to be flowing 
over the virtual route after repeated analysis requests, there may be a 
problem in the origin node itself or with the first transmission group in 
the explicit route. | 


TRANSIENT VR BLOCK - VR CONGESTION 
One of the two samples indicated that NcP is withholding a virtual route 
pacing response because the PiU buffer pool threshold has been 
exceeded. 
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This is a transient condition that most likely will go away on its own. If 
the condition occurs repeatedly, the system programmer may want to 
tune the network so that the piu buffer pool threshold is not exceeded so 
often. The piu buffer pool threshold cannot be changed. 


EXPLICIT ROUTE IS CONGESTED 


NCP is not withholding a virtual route pacing response and NCP has not 
received all the data that VTAM has sent. This may be caused by con- 
gestion along the explicit route between the sender and receiver of the 
virtual route (referred to as complex congestion). No data was received 
by NCP during the time between the two samples. 


Further problem determination may be required to isolate the specific 
node that is blocking the traffic. Use NPM to do this problem determi- 
nation task. 


VR BLOCKED BY DEST. NODE CONGESTION 


In configurations where NcpP is the receiver, the NCP is withholding a 
virtual route pacing response and the piu buffer pool threshold has not 
been exceeded. Since, at this point in the analysis, a virtual route can 
be blocked only by the Piu buffer pool threshold being exceeded or by 
the NCP being in slowdown, the NcP must be in slowdown if the virtual 
route is blocked and the piu buffer pool threshold is not exceeded. This 
condition must also be stable across the two samples and data must not 
have flowed across the virtual route during the time between the two 
samples. 


You should perform further problem determination to determine why 
the NCP is in slowdown and take some corrective action to insure that 
this condition does not occur again. Under normal circumstances, the 
NCP will eventually get itself out of slowdown, and the virtual route 
pacing response will be sent to unblock the virtual route. If this does 
not happen automatically, the NcP must be restarted. 


In configurations where VTAM is the receiver, this condition is reached 
whenever the sender is waiting for a virtual route pacing response and 
all of the Pius sent by the sender have been received at the receiver. 


VR BLOCKED BY ER CONGESTION 


Both samples indicate that the sender is waiting for a virtual route 
pacing response, the receiver has not received all the data sent by the 
sender, and data has not been sent during the time between the two 
samples. 


Further problem determination may be required to isolate the specific 
node that is blocking the traffic. Use NPM to do this problem determi- 
nation task. 


VR BLOCKED BY MIXED TYPE CONGESTION 


The virtual route is blocked and the reason is different on the two 
samples. The reason on the first sample is that the piu buffer pool 
threshold is exceeded. On the second sample, the virtual route is still 
blocked, but the piu buffer threshold is no longer exceeded. Instead, the 
NCP is in Slowdown. These two conditions cannot occur in the reverse 
order. Data must not have flowed across the virtual route during the 
time between the two samples. 


The fact that the cause of the blocked virtual route has changed 
between the two samples indicates that this is probably a temporary 


condition. If the slowdown condition persists, further problem determi- 
nation will be required to determine the cause of this condition. 


VR BLOCKED BY VR CONGESTION 
The ncP is withholding a virtual route pacing response and the Plu buffer 
pool threshold has been exceeded. This condition must be stable 
across the two samples and data must not have flowed across the 
virtual route during the time between the two samples. 


The virtual route will be unblocked after enough of the data that was 
received over the virtual route is sent out of the NcP so that the Piu 
buffer pool threshold is no longer exceeded. If this does not happen 
automatically, do further problem determination to determine why the 
data is not leaving the NcP. In addition, the system programmer may 
need to alter the LOGMODE and cos definitions to map fewer sessions to 
the subject virtual route. 


VR BLOCKED - DEST. NODE IN CWALL 
A CWALL condition indicates that the NcP has a severe buffer shortage. 
No data will be received by the NcP until the CWALL condition is allevi- 
ated. A CWALL condition can be detected only if the condition occurs 
after the virtual route status data request (ROUTE-TEST) is received and 
before the virtual route status data reply (RSP(ROUTE-TEST)) is sent. 


VR BLOCKED - SEQUENCE ERROR 
A sequence error indicates that the ncp had discarded Pius that have 
arrived with unexpected sequence numbers. This usually occurs when 
the piu with the expected sequence number has been lost. Thus, the 
condition is not likely to go away on its own; deactivate the virtual 
route. 


VR BLOCKED - UNABLE TO DETERMINE REASON 
The virtual route status data indicates that an ncP is withholding a 
virtual route pacing response but the reason for this cannot be deter- 
mined. This usually means that the data is inconsistent in some way, a 
condition that should not occur. 


If this conclusion cannot be recreated by subsequent operator requests 
for virtual route analysis, it was probably caused by a timing condition 
and should be ignored. If the conclusion is reached repeatedly, there is 
an error in the data being returned to NLDM. Call IBM for help. 


VR BLOCKED - VRPRS SENT BUT NOT RECEIVED 
The sender indicates that the virtual route is blocked while waiting for a 
virtual route pacing response; however, the receiving NCP does not indi- 
cate that it is withholding a virtual route pacing response. You can only 
assume that a virtual route pacing response has been sent but not 
received. For this conclusion to be reached, data must not have been 
sent during the time between the two samples. 


If this condition goes away with a subsequent analysis request, the 
virtual route is operating properly. If the condition persists, a virtual 
route pacing response has most likely been lost and the virtual route 
must be deactivated to recover. 
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Appendix D. National Receive Levels 


This information is provided to give you a basis to judge acceptable receive signal 
levels. This information on satisfactory transmission levels is given on the hard- 
ware monitor (NPDA) panels: 


e¢ Modem and Line Status 
e Link Status and Test Results. 


For switched lines, the acceptable signal levels are: 
Germany -6 to -46 dBm 
Italy 0 to -43 dBm 
New Zealand -5 to -35 dBm. 


For non-switched lines, the acceptable signal levels are: 


Belgium 0 to -43 dBm 
France 0 to -43 dBm 
Germany -40 dBm 
Italy -40 dBm 
Japan -40 dBm 
Netherlands -43 dBm 
Spain 0 to -20 dBm 
Switzerland -40 dBm 


United Kingdom not greater than -60 dBm. 
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Information/Management 


The hardware monitor Information/Management link lets you send event data to 
Information/Management and lets you open problem records. From the hardware 
monitor Alerts-Static, Alerts-History, Most Recent Events, and Event Summary 
panels, you can transfer problem data directly into an Information/Management 
problem record. The NetView operator ID must be included in an 
Information/‘Management privilege class which has authority to update 
Information/Management records. The data transferred from hardware monitor 
(NPDA) to Information/Management is shown as follows: 
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* indicates that this field may be truncated. 


Note: The hardware monitor passes up to five resource names to define the failing 
resource. For example, an IBM 3710 Network Controller can send: 


e NCP name 
® LINE name 
e PU name 
¢ LINE name 
e PU name. 


The problem entry person can enter additional data about a specific problem into 
Information/Management. 


Information/Management does not support the printing of Kanji characters. Unex- 
pected results may occur. 
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The following chart lists the PF key defaults. Each component or function is listed 
with changes to the default PF keys. If an entry is left blank, the standard PF key 
function is used. If an entry contains N/A, the standard command associated with 
the PF key cannot be used in the component. 


You can enter DISPFK for online information (in all components except the status 


monitor) on the default PF keys for that component. (Ask your lead operator if your 
default PF key settings are established.) 


Deviations 


4700 
Library Session | Hardware t | Command 
Log Browse | HELP Browse Monitor | Monitor Sania Facility 


Copy 

Screen 
Hold Hold Hold 
Screen Screen Screen 
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NetView Publications 


The following paragraphs briefly describe the library of 
manuals associated with NetView Release 2. 


Learning about NetView (SK2T-0292) 


This pc-based tutorial introduces SNA and basic network 
management concepts to NetView users. It is primarily 
designed for new or inexperienced network operators. 


NetView Installation and Administration Guide 
(SC30-3476) 


This guide helps system programmers install and 
prepare NetView for operation. It is arranged in a sim- 
plified, step-by-step style and is meant to be used in 
conjunction with the sample network documented in 
Network Program Products Samples. 


NetView Administration Reference (SC30-3361) 


This reference book is for system programmers and 
network operators who need a complete understanding 
of NetView’s resource definition statements. This book 
lists each statement in alphabetical order giving its 
purpose and location. 


NetView Customization (SC30-3462) 


This manual is designed for system programmers and 
others who want to customize NetView to reflect their 
network’s needs or operating procedures. It discusses 
how to write exit routines, command processors, and 
subtasks and explains how to modify NetView help 
panels and problem determination displays. 


NetView Directory of Programming Interfaces for Cus- 
tomers (GC31-6005) 


This document lists the interfaces NetView provides for 
use with customer programs that run under the vm 
operating system. Intended for system programmers 
and application programmers, this document directs 
the user to detailed interface descriptions in other 
NetView manuals. In addition, this document lists the 
NetView data sets that customer programs may access, 
as well as the NetView macros that may be used as a 
programming interface. 


NetView Command Lists (SC30-3423) 


This manual explains how to simplify network operator 
tasks by using command lists (CLISTS). It provides step- 
by-step instructions for writing simple and advanced 
CLISTS and for migrating from NCCF message automation 
to NetView message automation. 


NetView Operation Primer (SC30-3363) 


This book, written for new network operators, provides 
a basic description of the network management task. 
Topics include starting and stopping a network, control- 
ling resources, monitoring a network, and gathering the 
necessary data to report a problem. 


NetView Operation (SC30-3364) 


This manual, designed for system programmers and 
experienced network operators, provides a comprehen- 
sive explanation of network management using 
NetView. Topics include detailed command explana- 
tion and panel flows, as well as information on how the 
various components interact with each other. 


NetView Messages (SC30-3365) 


This manual helps system programmers interpret and 
respond to the error messages issued by NetView. It 
explains briefly what each message means, what the 
system action is, what the operator response should 
be, and what the related commands are. 


NetView Operation Scenarios (SC30-3376) 


This book shows how to use NetView in a problem 
determination setting in order to identify and to solve 
common network operation problems. 


NetView Command Summary (SX27-3620) 


This reference card provides network operators witha 
quick way to find the format of all the commands and 
the more commonly used CLists for NetView. The com- 
mands are listed in alphabetical order by component. 


NetView Diagnosis (LY30-5587) 
This manual aids system programmers in identifying a 
NetView problem, classifying it, and then accurately 


describing it to an IBM Support Center so a solution can 
be found. 
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NetView Hardware Problem Determination Reference 
(SC30-3366) 


This manual provides alert information beyond that 
offered in the NetView panels. It is designed to assist 
system programmers, help-desk operators, and 
network operators determine which specific component 
is causing the alert. It includes formats of trace 
records sent to NetView from the products that NetView 
supports. 


NetView Problem Determination Supplement for Man- 
agement Services Major Vectors 0001 and 0025 
(LD21-0023) 


This supplement describes major vectors 0001 and 
0025. It is intended for system programmers and 
network operators involved in problem determination 
or diagnosis tasks. For example, the supplement may 
be used for the generic alert option and other problem 
determination tasks. 


NetView 5822 Supplement (SD21-0016) 


This supplement introduces NetView’s support of the 
5822 Data Service Unit/Channel Service Unit (psu/csu) 
for MvS/370 and MVS/XA operating systems. Written for 
NetView system planners, system programmers, and 
network operators, this supplement explains how to 
install, customize, and use NetView’s 5822 support. 


Automated Operations Publications 


The following paragraphs briefly describe the library of 
manuals for Automated Operations. 


Automated Operations Planning Guide (SC30-3474) 


This book is for system planners and system program- 
mers who are developing a strategy for network auto- 
mation using NetView. The book covers an assortment 
of planning tasks, such as learning what automated 
operations is, deciding which network components can 
be automated, and identifying repetitive operator tasks. 


Automated Operations Using NetView Command Lists 
(SC30-3477) 


This manual is designed to help system programmers 
and network operators write NetView command lists 
(CLISTS). It gives step-by-step procedures for designing, 
writing, and testing CLISTs. 
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NetView/PC Publications 

The following list shows the publication for NetView/PC. 
NetView/PC Planning and Bperaeen Guide (SC30-3408) 
This 2-part book explains how to plan for, install, 
operate, and diagnose the NetView/PC program. It also 


provides practical scenarios and a screen-by-screen 
section for planning configuration set maintenance. 


Other Network Program Products 
Publications 


For more information about the manuals listed in this 
section, see Network Program Products Bibliography 


and Master Index. 
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Glossary 


This glossary defines important NCP, NetView, 
NetView/PC, SSP, and VTAM abbreviations and terms. 
It includes information from the /BM Vocabulary for 
Data Processing, Telecommunications, and Office 
Systems, GC20-1699. Definitions from the American 
National Dictionary for Information Processing are 
identified by an asterisk (*). Definitions from draft pro- 
posals and working papers under development by the 
International Standards Organization, Technical Com- 
mittee 97, Subcommittee 1 are identified by the symbol 
(TC97). Definitions from the CCI/T Sixth Plenary 
Assembly Orange Book, Terms and Definitions and 
working documents published by the Consultative Com- 
mittee on International Telegraph and Telephone of the 
International Telecommunication Union, Geneva, 1980 
are preceded by the symbol (CCITT/ITU). Definitions 
from published sections of the /SO Vocabulary of Data 
Processing, developed by the International Standards 
Organization, Technical Committee 97, Subcommittee 1 
and from published sections of the /SO Vocabulary of 
Office Machines, developed by subcommittees of ISO 
Technical Committee 95, are preceded by the symbol 
(ISO). 


For abbreviations, the definition usually consists only of 
the words represented by the letters; for complete defi- 
nitions, see the entries for the words. 


Reference Words Used in the Entries 


The following reference words are used in this 
glossary: 


Deprecated term for. indicates that the term 
should not be used. It refers to a preferred term, 
which is defined. 


Synonymous with. Appears in the commentary of 
a preferred term and identifies less desirable or 
less specific terms that have the same meaning. 


Synonym for. Appears in the commentary of a less 


desirable or less specific term and identifies the 
preferred term that has the same meaning. 


Contrast with. Refers to a term that has an 
opposed or substantively different meaning. 


See. Refers to multiple-word terms that have the 
same last word. 


See also. Refers to related terms that have similar 
(but not synonymous) meanings. 
abend. Abnormal end of task. 


abnormal end of task (abend). Termination of a task 
before its completion because of an error condition that 


cannot be resolved by recovery facilities while the task 
is executing. 


ACB. (1) In VTAM, application control block. (2) In 
NCP, adapter control block. 


ACB address space. In VTAM, the address space in 
which the ACB is opened. See associated address 
space and session address space. 


ACB name. (1) The name of an ACB macroinstruction. 
(2) Aname specified in the ACBNAME parameter of a 
VTAM APPL statement. Contrast with network name. 


ACB-based macroinstruction. In VITAM, a macroin- 
struction whose parameters are specified by the user 
in an access method control block. 


accept. For a VITAM application program, to establisha 
session with a logical unit (LU) in response to a CINIT 
request from a system services control point (SSCP). 
The session-initiation request may begin when a ter- 
minal user logs on, a VTAM application program issues 
a macroinstruction, or a VTAM operator issues a 
command. See also acquire (1). 


access method. A technique for moving data between 
main storage and input/output devices. 


accounting exit routine. In VTAM, an optional installa- 
tion exit routine that collects statistics about session 
initiation and termination. 


ACF. Advanced Communications Function. 


ACF/NCP. Advanced Communications Function for the 
Network Control Program. Synonym for NCP. 


ACF/SSP. Advanced Communications Function for the 
System Support Programs. Synonym for SSP. 


ACF/TAP. Advanced Communications Function for the 
Trace Analysis Program. Synonym for TAP. 


ACF/TCAM. Advanced Communications Function for 
the Telecommunications Access Method. Synonym for 
TCAM. 


ACF/IVTAM. Advanced Communications Function for 
the Virtual Telecommunications Access Method. 
Synonym for VTAM. 


ACF/VTAME. Advanced Communications Function for 


the Virtual Telecommunications Access Method Entry. 
Synonym for VTAME. 
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acquire. (1) For a VTAM application program, to ini- 
tiate and establish a session with another logical unit 
(LU). The acquire process begins when the application 
program issues a macroinstruction. See also accept. 
(2) To take over resources that were formerly con- 
trolled by an access method in another domain, or to 
resume control of resources that were controlled by 
this domain but released. Contrast with release. See 
also resource takeover. 


activate. To make a resource of a node ready to 
perform the functions for which it was designed. Con- 
trast with deactivate. 


active. (1) The state a resource is in when it has been 
activated and is operational. Contrast with inactive, 
pending, and inoperative. (2) Pertaining to a major or 
minor node that has been activated by VTAM. Most 
resources are activated as part of VTAM start proc- 
essing or as the result of a VARY ACT command. 


active application. The application subsystem currently 
in an extended recovery facility (XRF) session with a 
terminal user. See a/ternate application. 


adapter. Hardware card that allows a device, such as a 
PC, to communicate with another device, such as a 
~ monitor, a printer, or other I/O device. 


adapter control block (ACB). In NCP, a control block 
that contains line control information and the states of 
I/O operations for BSC lines, SS lines, or SDLC links. 


adaptive session pacing. Synonym for adaptive 
session-level pacing. 


adaptive session-level pacing. A form of session-level 
pacing in which session components exchange pacing 
windows that may vary in size during the course of a 
session. This allows transmission to adapt dynamically 
to variations in availability and demand of buffers ona 
session by session basis. Session pacing occurs 
within independent stages along the session path 
according to local congestion at the intermediate 
nodes. Synonymous with adaptive session pacing. 
See pacing, session-level pacing, and virtual route 
pacing. 


address aliasing. See network address translation. 
address translation. See network address translation. 
adjacent NCPs. Network contro! programs (NCPs) that 
are connected by subarea links with no intervening 


NCPs. 


adjacent networks. Two SNA networks joined by a 
common gateway NCP. 


adjacent nodes. Two nodes that are connected by one 
or more data links with no intervening nodes. 
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adjacent SSCP table. A table containing lists of the 
system services control points (SSCPs) that VTAM can 
be in session with or can use to reach destination 
SSCPs in the same network or in other networks. The 
table is filed in the VTAM definition library. 


adjacent subareas. Two subareas connected by one or 
more links with no intervening subareas. See also 
subarea. 


Advanced Communications Function (ACF). A group of 
IBM licensed programs (principally VTAM, TCAM, NCP, 
and SSP) that use the concepts of Systems Network 
Architecture (SNA), including distribution of function 
and resource sharing. 


Advanced Program-to-Program Communication 
(APPC). A synonym for logical unit (LU) 6.2 and its 
implementations. 


alert. (1) In SNA, a record sent to a system problem 
management focal point to communicate the existence 
of an alert condition. (2) In the NetView program, a 
high priority event that warrants immediate attention. 
This data base record is generated for certain event 
types that are defined by user-constructed filters. 


alert condition. A problem or impending problem for 
which some or all of the process of problem determi- 
nation, diagnosis, and resolution is expected to require 
action at a control point. 


alert sender. The SNA entity, either a physical unit 
(PU) or a control point, that sends or causes a for- 
matted alert to be sent to a focal point. 


alias address. An address used by a gateway NCP and 
a gateway system services control point (SSCP) in one 
network to represent a logical unit (LU) or SSCP in 
another network. 


alias name. A name defined in a host used to repre- 
sent a logical unit name, logon mode table name, or 
class-of-service name in another network. This name 
is defined to a name translation program when the 
alias name does not match the real name. The alias 
name translation program is used to associate the real 
and alias names. 


alias name translation facility. A function for con- 
verting logical unit names, logon mode table names, 
and class-of-service names used in one network into 
equivalent names to be used in another network. 
Available with NetView or NCCF licensed programs. 


allocate. A logical unit (LU) 6.2 application program 
interface (API) verb used to assign a session to a con- 
versation for the conversation’s use. Contrast with 
deallocate. | 


alternate application. The subsystem that is prepared 
to take over a particular active application’s extended 


recovery facility (XRF) sessions with terminal users in 
case the application fails. See active application. 


alternate path. (1) Another channel an operation can 
use after a failure. See also alternate path retry (APR). 
(2) In CCP, one of two paths that can be defined for 
information flowing to and from physical units attached 
to the network by means of an IBM 3710 Network Con- 
troller. See primary path. 


alternate path retry (APR). A facility that allows a failed 
I/O operation to be retried on another channel assigned 
to the device performing the I/O operation. It also pro- 
vides the capability to establish other paths to an 
online or offline device. 


alternate route. A secondary or backup route that is 
used if normal routing is not possible. 


ancillary equipment. Synonym for auxiliary equipment. 


any-mode. In VTAM: (1) The form of a RECEIVE 
request that obtains input from any one (unspecified) 
session. (2) The form of an ACCEPT request that com- 
pletes the establishment of a session by accepting any 
one (unspecified) queued CINIT request. Contrast with 
specific-mode. See continue-any mode. See also 
accept. | 


API. Appiication program interface. 
APPC. Advanced Program-to-Program Communication. 


application control block (ACB). A control block that 
links an application program to VSAM or VTAM. 


application program. (1) A program written for or by a 
user that applies to the user’s work. (2) A program 
used to connect and communicate with stations ina 
network, enabling users to perform application-oriented 
activities. 


application program exit routine. In VTAM, a user- 
written exit routine that performs functions for a partic- 
ular application program and is run as part of the 
application program. Examples are the RPL exit 
routine, the EXLST exit routine, and the TESTCB exit 
routine. Contrast with installation exit routine. 


application program identification. The symbolic name 
by which an application program is identified to VTAM. 
It is specified in the APPLID parameter of the ACB 
macroinstruction. 


application program interface (API). (1) The formally 
defined programming language interface between an 
IBM system control program or licensed program and 
its user. (2) The interface through which an application 
program interacts with an access method. In VTAM, it 
is the language structure used in control blocks so that 


application programs can reference them and be identi- 
fied to VTAM. 


application program major node. A group of applica- 
tion program minor nodes. In the VTAM definition 
library, it is a member, book, or file that contains one 
or more APPL statements, which represent application 
programs. In MVS, it is a member of the library; in 
VSE, it is a book; and in VM, it is a CMS file of filetype 
VTAMLST. 


APR. Alternate path retry. 


ASCII. American National Standard Code for Informa- 
tion Interchange. 


associated address space. In VTAM, the address 
space in which RPL-based requests are issued that 
specify an ACB opened in another address space. 


asynchronous exit routine. In VITAM, an RPL exit 
routine or an EXLST exit routine other than LERAD or 
SYNAD. Contrast with inline exit routine. 


asynchronous operation. Simultaneous operations of 
software or hardware. In software, an operation, such 
as a request for session establishment or data transfer, 
in which the application program is allowed to continue 
execution while the operation is performed. The 
access method informs the appiication program afier 
the operation is completed. Contrast with synchronous 
operation. 


asynchronous request. In VTAM, a request for an asyn- 
chronous operation. Contrast with synchronous 
request. 


attaching device. Any device that is physically con- 
nected to a network and can communicate over the 
network. 


authorization exit routine. In VTAM, an optional instal- 
lation exit routine that approves or disapproves 
requests for session initiation. 


authorized operator. In the NetView program, an oper- 
ator who has been authorized to receive undeliverable 
messages and lost terminal messages. 


authorized path. In VTAM for MVS, a facility that 
enables an application program to specify that a data 
transfer or related operation be carried out in a privi- 
leged and more efficient manner. 


authorized receiver. In the NetView program, an 
authorized operator who receives all the unsolicited 
and authorized-receiver messages not assigned to a 
specific operator. | 


auto-baud. In CCP, a line speed designation by which 


the IBM 3710 Network Controller determines the line 
speed. 
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automatic activation. In VTAM, the activation of links 
and link stations in adjacent subarea nodes as a result 
of channel device name or RNAME specifications 
related to an activation command that names a subarea 
node. See direct activation. 


automatic deactivation. In VTAM, the deactivation of 
links and link stations in adjacent subarea nodes as a 
result of a deactivation request that names a subarea 
node. Automatic deactivation occurs only for automat- 
ically activated links and link stations that have not also 
been directly or indirectly activated. See direct deacti- 
vation. 


automatic logon. (1) A process by which VTAM auto- 
matically creates a session-initiation request to estab- 
_lish a session between two logical units (LUs). The 
session will be between a designated primary logical 
unit (PLU) and a secondary logical unit (SLU) that is 
neither queued for nor in session with another PLU. 
See also controlling application program and control- 
ling logical unit. (2) in VM, a process by whicha 
virtual machine is initiated by other than the user of 
that virtual machine. For example, the primary VM 
operator’s virtual machine is activated automatically 
during VM initialization. 


automatic reactivation. In NetView, the activation of a 
node from the inactive state without any action by the 
network operator. 


auto-parity. In CCP, a method that allows an IBM 3710 
Network Controller to decide whether to use odd or 
even parity when communicating with an SS terminal. 


auxiliary equipment. Equipment not under direct 
control of the processing unit. Synonymous with ancil- 
lary equipment. 


auxiliary network address. In VTAM, any network 
address, except the main network address, assigned to 
a logical unit capable of having parallel sessions. Con- 
trast with main network address. 


available. In VTAM, pertaining to a logical unit that is 
active, connected, enabled, and not at its session limit. 


back-level. Pertaining to an earlier release of an IBM 
product, which may not support a particular, current 
function. 


back-to-back gateways. Two gateways separated by 
one intervening network that contains no gateway 
system services control point (SSCP) function involved 
with either of the two gateway NCPs. 


backup session. The session that replaces the failing 
primary extended recovery facility (XRF) session 
between a terminal user and the active subsystem. 
balanced routing. A method of assigning network 


routes so that all routes are used equally. 
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BASE disk. The virtual disk that contains the text decks 
and macroinstructions for VTAM and VM SNA console 
support (VSCS). It also contains control files and 
sample files used when running VTAM on the VM oper- 
ating system. See DELTA disk, MERGE disk, RUN disk, 
and ZAP disk. 


base set. The set of functions, including verbs, param- 

eters, return codes, and what-received indications that 

is supported by all products that implement a particular 
architecture. See also option set. 


basic conversation. A conversation that supports the 
functions of the basic conversation protocol boundary 
defined by LU 6.2. That format requires data to be sent 
as logical records consisting of a 2-byte length prefix 
followed by the data. See also mapped conversation. 


basic information unit (BIU). In SNA, the unit of data 
and control information that is passed between half- 
sessions. It consists of a request/response header 
(RH) followed by a request/response unit (RU). 


basic transmission unit (BTU). In SNA, the unit of data 
and control information passed between path control 
components. A BTU can consist of one or more path 
information units (PiUs). See also blocking of PIUs. 


begin bracket. In SNA, the value (binary 1) of the 
begin-bracket indicator in the request header (RH) of 
the first request in the first chain of a bracket; the value 
denotes the start of a bracket. Contrast with end 
bracket. See also bracket. 


bidder. In SNA, the LU-LU half-session defined at 
session activation as having to request and receive 
permission from the other LU-LU half-session to begin 
a bracket. Contrast with first speaker. See also 
bracket protocol and contention. 


binary synchronous communication (BSC). (1) Com- 
munication using binary synchronous line discipline. 
(2) A uniform procedure, using a standardized set of 
control characters and control character sequences, for 
synchronous transmission of binary-coded data 
between stations. 


binary synchronous transmission. Data transmission in 
which synchronization of characters is controlled by 
timing signals generated at the sending and receiving 
stations. See also start-stop transmission and Syn- 
chronous Data Link Control. | 


bind. In SNA, a request to activate a session between 
two logical units (LUs). See also session activation 
request. Contrast with UNBIND. 


BIU. Basic information unit. 


BIU segment. In SNA, the portion of a basic information 
unit (BIU) that is contained within a path information 


unit (PIU). It consists of either a request/response 
header (RH) followed by all or a portion of a 
request/response unit (RU), or only a portion of an RU. 


blocking of PIUs. In SNA, an optional function of path 
control that combines multiple path information units 
(PIUs) into a single basic transmission unit (BTU). 


BNN. Boundary network node. 


boundary function. (1) A capability of a subarea node 
to provide protocol support for attached peripheral 
nodes, such as: (a) interconnecting subarea path 
control and peripheral path control elements, (b) per- 
forming session sequence numbering for low-function 
peripheral nodes, and (c) providing session-level 
pacing support. (2) The component that provides these 
capabilities. See also boundary node, network 
addressable unit (NAU), peripheral path control, 
Subarea node, and subarea path control. 


boundary network node (BNN). Deprecated term for 
boundary node. 


boundary node. (1) A subarea node with boundary 
function. See subarea node (including illustration). 
See also boundary function. (2) The programming 
component that performs FID2 (format identification 
type 2) conversion, channel data link control, pacing, 
and channel or device error recovery procedures for a 
locally attached station. These functions are similar to 
those performed by a network control program for an 
NCP-attached station. 


bracket. In SNA, one or more chains of request units 
(RUs) and their responses that are exchanged between 
the two LU-LU half-sessions and that represent a trans- 
action between them. A bracket must be completed 
before another bracket can be started. Examples of 
brackets are data base inquiries/replies, update trans- 
actions, and remote job entry output sequences to work 
stations. See also begin bracket and end bracket. 


bracket protocol. In SNA, a data flow control protocol 
in which exchanges between the two LU-LU half- 
sessions are achieved through the use of brackets, with 
one LU designated at session activation as the first 
speaker and the other as the bidder. The bracket pro- 
tocol involves bracket initiation and termination rules. 
See also bidder and first speaker. 


branch exchange. A switching system that provides 
telephone communication between branch stations and 
external networks. 


browse. A way of looking at a file that does not allow 
you to change it. 


BSC. Binary synchronous communication. 


BTU. Basic transmission unit. 


buffer. A portion of storage for temporarily holding 
input or output data. 


buffer group. In VTAM, a group of buffers associated 
with one or more contiguous, related entries in a buffer 
list. The buffers may be located in discontiguous areas 
of storage and may be combined into one or more 
request units. 


buffer list. In VTAM, a contiguous set of control blocks 
(buffer list entries) that allow an application program to 
send function management data (FMD) from a number 
of discontiguous buffers with a single SEND macroin- 
struction. 


buffer list entry. A control block within a buffer list that 
points to a buffer containing function management data 
(FMD) to be sent. 


cancel closedown. A closedown in which VTAM is 
abnormally terminated either because of an unex- 
pected situation or as the result of an operator 
command. See also orderly closedown and quick 
closedown. 


CBX. Computerized branch exchange. 
CCP. Configuration control program facility. 
CCS. Console communication services. 


CDNM session. Cross-domain network manager 
session. 


CDRM. Cross-domain resource manager. 
CDRSC. Cross-domain resource. 

CEB. Conditional end bracket. 

chain. See RU chain. 


change-direction protocol. In SNA, a data flow control 
protocol in which the sending logical unit (LU) stops 
sending normal-flow requests, signals this fact to the 
receiving LU using the change-direction indicator (in 
the request header of the last request of the last chain), 
and prepares to receive requests. 


channel. * A path along which signals can be sent, for 
example, data channel, output channel. See data 
channel and input/output channel. See also link. 


channel adapter. A communication controller hard- 
ware unit used to attach the controller to a System/360 
or a System/370 channel. 


channel-attached. Pertaining to the attachment of 


devices directly by System 370 input-output channels to 
a host processor. 
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channel-attachment major node. (1) A major node that 


includes an NCP that is channel-attached to a data host. 


(2) A major node that may include minor nodes that 
are the line groups and lines that represent a channel 
attachment to an adjacent (channel-attached) host. 

(3) In VM or VSE operating systems, a major node that 
may include minor nodes that are resources (host 
processors, NCPs, line groups, lines, SNA physical 
units and logical units, cluster controllers, and termi- 
nals) attached through a communication adapter. 


channel link. A System/370 I/O channel to control unit 
interface that has an SNA network address. A channel 
link can be either a subarea link or a peripheral link. 
See also /ink and subarea link. 


character-coded. Synonym for unformatted. 


character times. In CCP, the maximum number of 
times the temporary text delay character can be sent to 
a terminal before the operation stops or that can be 
sent between the end of a receive and the beginning of 
a transmit operation. 


CICS. Customer Information Control System. 
CID. Communication identifier. 


CINIT. A network services request sent from a system 
services control point (SSCP) to a logical unit (LU) 
asking that LU to establish a session with another LU 
and to act as the primary end of the session. 


class of service (COS). In SNA, a designation of the 
‘path control network characteristics, such as path 
security, transmission priority, and bandwidth, that 
apply to a particular session. The end user designates 
class of service at session initiation by using a sym- 
bolic name that is mapped into a list of virtual routes, 
any one of which can be selected for the session to 
provide the requested level of service. 


cleanup. A network services request, sent by a system 
services control unit (SSCP) to a logical unit (LU), that 
Causes a particular LU-LU session with that LU to be 
ended immediately and without the participation of 
either the other LU or its SSCP. 


clear data. Data that is not enciphered. Synonymous 
with plaintext. 


clear session. A session in which only clear data is 
transmitted or received. Contrast with cryptographic 
session. 


CLIST. Command list. 


clocking. !n CCP, the use of clock pulses to synchro- 
nize data and control characters sent on a line. 
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closedown. The deactivation of a device, program, or 
system. See cancel closedown, orderly closedown, 
and quick closedown. 


cluster controller. A device that can control the 
input/output operations of more than one device con- 
nected to it. A cluster controller may be controlled by a 
program stored and executed in the unit; for example, 
the IBM 3601 Finance Communication Controller. Or it 
may be controlled entirely by hardware; for example, 
the IBM 3272 Control Unit. 


CMC. Communication management configuration. 
CMS. Conversational Monitor System. 

CNM. Communication network management. 
CNOS. Change number of sessions. 


code point. In the NetView/PC program and in the 
NetView program, a 1- or 2-byte hexadecimal value that 
indexes a text string stored at an alert receiver and is 
used by the alert receiver to create displays of alert 
information. 


combined alert. In the NetView program, an alert that 
includes both a non-generic alert and a generic alert in 
one network management vector transport (NMVT). 


command. (1) A request from a terminal for the per- 
formance of an operation or the execution of a partic- 
ular program. (2) In SNA, any field set in the 
transmission header (TH), request header (RH), and 
sometimes portions of a request unit (RU), that initiates 
an action or that begins a protocol; for example: (a) 
Bind Session (session-control request unit), a 
command that activates an LU-LU session, (b) the 
change-direction indicator in the RH of the last RU of a 
chain, (c) the virtual route reset window indicator ina 
FID4 transmission header. See also VTAM operator 
command. 


command facility. The component of the NetView 
program that is a base for command processors that 
can monitor, control, automate, and improve the opera- 
tion of a network. 


command list (CLIST). In the NetView program, a 
sequential list of commands and contro! statements 
that is assigned a name. When the name is invoked (as 
a command) the commands in the list are executed. 


command processor. A program that performs an 
operation specified by a command. 


communication adapter. An optional hardware feature, 
available on certain processors, that permits communi- 
cation lines to be attached to the processors. 


communication common carrier. In the United States 
and Canada, a public data transmission service that 


provides the general public with transmission service 
facilities; for example, a telephone or telegraph 
company. 


communication control character. Synonym for trans- 
mission control character. 


communication control unit. A communication device 
that controls the transmission of data over lines ina 
network. Communication control units include trans- 
mission control units (such as the 2702 Transmission 
Control Unit) and communication controllers (such as 
the 3720 or 3725). 


communication controller. A type of communication 
control unit whose operations are controlled by one or 
more programs stored and executed in the unit; for 
example, the IBM 3725 Communication Controller. It 
manages the details of line control and the routing of 
data through a network. 


communication identifier (CID). In VTAM, a key for 
locating the control blocks that represent a session. 
The key is created during the session-establishment 
procedure and deleted when the session ends. 


communication line. Deprecated term for telecommu- 
nication line and transmission line. 


communication macroinstructions. In VTAM, the set of 
RPL-based macroinstructions used to communicate 
during a session. 


communication management configuration (CMC). 

(1) In VTAM, a technique for configuring a network that 
allows for the consolidation of many network manage- 
ment functions for the entire network in a single host 
processor. (2) A multiple-domain network configura- 
tion in which one of the hosts, called the communi- 
cation management configuration host, performs most 
of the controlling functions for the network, thus 
allowing the other hosts, called data hosts, to process 
applications. This is accomplished by configuring the 
network so that the communication management host 
owns most of the resources in the network that are not 
application programs. The resources that are not 
owned by the communication management host are the 
resources that are channel-attached stations of data 
hosts. 


communication management configuration host node. 
The type 5 host processor in a communication manage- 
ment configuration that does all network-control func- 
tions inthe network except for the control of devices 
channel-attached to data hosts. Synonymous with com- 
munication management host. Contrast with data host 
node. 


communication management host. Synonym for com- 
munication management configuration host node. Con- 
trast with data host. 


communication network management (CNM). The 
process of designing, installing, operating, and man- 
aging the distribution of information and controls © 
among end users of communication systems. 


communication network management (CNM) applica- 
tion program. A VTAM application program that issues 
and receives formatted management services request 
units for physical units. For example, NetView. 


communication network management (CNM) interface. 
The interface that the access method provides to an 
application program for handling data and commands 
associated with communication system management. 
CNM data and commands are handled across this inter- 
face. 


communication network management (CNM) processor. 
A program that manages one of the functions of a com- 
munications system. A CNM processor is executed 
under control of NetView. 


communication scanner processor (CSP). A processor 
in the 3725 Communication Controller that contains a 
microprocessor with control code. The code controls 
transmission of data over links attached to the CSP. 


composite end node (CEN). A group of nodes made up 
of a single type 5 node and its subordinate type 4 nodes 
that together support type 2.1 protocols. To a type 2.1 
node, a CEN appears as one end node. For example, 
NCP and VTAM act as a composite end node. 


compound command processor. A series of commands 
that appears to run as a single command. It can have 
interactions with other tasks or with tasks in other 
domains. 


computerized branch exchange (CBX). An exchange in 
which a central node acts as a high-speed switch to 
establish direct connections between pairs of attached 
nodes. 


conditional end bracket (CEB). In SNA, the value 
(binary 1) of the conditional end bracket indicator in the 
request header (RH) of the last request of the last chain 
of a bracket; the value denotes the end of the bracket. 
Contrast with end bracket. See also begin bracket and 
bracket. 


configuration. (1) (TC97) The arrangement of a com- 
puter system or network as defined by the nature, 
number, and the chief characteristics of its functional 
units. The term may refer to a hardware or a software 
configuration. (2) The devices and programs that 
make up a system, subsystem, or network. (3) In CCP, 
the arrangement of controllers, lines, and terminals 
attached to an IBM 3710 Network Controller. Also, the 
collective set of item definitions that describe such a 
configuration. 
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configuration control program (CCP) facility. An SSP 
interactive application program facility by which config- 
uration definitions for the IBM 3710 Network Controller 
can be created, modified, and maintained. 


configuration report program (CRP). An SSP utility 
program that creates a configuration report listing 
network resources and resource attributes for networks 
with NCP, EP, PEP, or VTAM. 


configuration restart. In VTAM, the recovery facility 
that can be used after a failure or deactivation ofa 
major node, VTAM, or the host processor to restore the 
domain to its status at the time of the failure or deacti- 
vation. 


configuration services. In SNA, one of the types of 
network services in the control point (CP) and in the 
physical unit (PU); configuration services activate, 
deactivate, and maintain the status of physical units, 
links, and link stations. Configuration services also 
shut down and restart network elements and modify 
path control routing tables and address-translation 
tables. See also maintenance services, management 
services, network services, and session services. 


connected. In VTAM, pertaining to a physical unit (PU) 
or logical unit (LU) that has an active physical path to 
the host processor containing the system services 
control point (SSCP) that controls the PU or LU. 


connection. Synonym for physical connection. 


connection point manager. In SNA, a component of the 
transmission control layer that: (1) performs session- 
level pacing of normal-flow requests, (2) checks 
sequence numbers of received request units, (3) veri- 
fies that request units do not exceed the maximum per- 
missible size, (4) routes incoming request units to their 
destinations within the half-session, and (5) enciphers 
and deciphers FMD request units when cryptography is 
selected. The connection point manager coordinates 
the normal and expedited flows for one half-session. 


console communications services (CCS). The SNA 
facility that acts as an interface between the control 
program and the VSCS component of VTAM for VM. 


contention. A situation in which two logical units (LUs) 
that are connected by an LU 6.2 session both attempt to 
allocate the session for a conversation at the same 
time. The control operator assigns “winner” and 
“loser” status to the LUs so that processing may con- 
tinue on an orderly basis. The contention loser 
requests permission from the contention winner to allo- 
cate a conversation on the session, and the contention 
winner either grants or rejects the request. See also 
bidder. 


contention polarity. The role of each LU when con- 


tention occurs for use of a session. One LU is the con- 
tention winner and the other LU is the contention lioser. 
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continuation mode. In VTAM, the state of a conversa- 
tion or session: either continue-any mode or continue- 
specific mode. 


continue-any mode. In VTAM, the state of a session or 
conversation that allows its input to satisfy a RECEIVE 
request issued in any-mode. While this state exists, 
input on the session or conversation can also satisfy 
RECEIVE requests issued in specific-mode. For con- 
versations, continue-any. mode is further qualified as 
either buffer continue-any or logical record 
continue-any. This specifies whether VTAM is to 
receive the data in terms of logical records or buffers. 
Contrast with continue-specific mode. 


continue-specific mode. In VTAM, the state of a 
session or conversation that allows its input to satisfy 
only RECEIVE requests issued in specific-mode. Con- 
trast with continue-any mode. 


control block. (ISO) A storage area used by a computer 
program to hold control information. 


control operator. For logical unit (LU) 6.2, a service 
transaction program that describes and controls the 
availability of certain resources. For example, it 
describes network resources accessed by the local LU 
and it controls session limits between the LU and its 
partners. See also contention. 


control point (CP). (1) A system services control point 
(SSCP) that provides hierarchical control of a group of 
nodes in a network. (2) A control point (CP) local toa 
specific node that provides control of that node, either 
in the absence of SSCP control (for type 2.1 nodes 
engaged in peer to peer communication) or to supple- 
ment SSCP control. 


control program (CP). The VM operating system that 
manages the real processor’s resources and is respon-_ 
sible for simulating System/370s for individual users. 


controlling application program. in VTAM, an applica- 
tion program with which a secondary logical unit (other 
than an application program) is automatically put in 
session whenever the secondary logical unit is avail- 
able. See also automatic logon and controlling logical 
unit. 


controlling logical unit. In VTAM, a logical unit with 
which a secondary logical unit (other than an applica- 
tion program) is automatically put in session whenever 
the secondary logical unit is available. A controlling 
logical unit can be either an application program ora 
device-type logical unit. See also automatic logon and 
controlling application program. ~ 


control statement. A statement in a command list that 
controls the processing sequence of the command list 
or allows the command list to send messages to the 
operator and receive input from the operator. 


conversation. In SNA, a logical connection between 
two transaction programs using an LU 6.2 session. 
Conversations are delimited by brackets to gain exclu- 
sive use of a session. 


conversation-level security. See session-level 
security. See also end-user verification. 


Conversational Monitor System (CMS). A VM applica- 
tion program for general! interactive time sharing, 
problem solving, and program development. 


converted command. An intermediate form of a 
character-coded command produced by VTAM through 
use of an unformatted system services definition table. 
The format of a converted command is fixed; the unfor- 
matted system services definition table must be con- 
structed in such a manner that the character-coded 
command (as entered by a logical unit) is converted 
into the predefined, converted command format. See 
also unformatted. 


COS. Class of service. 


coupler. A hardware device that connects a modem to 
a public phone system in much the same way that a 
telephone does. 


CP. (1) Control program. (2) Control point. 
cross keys. Synonym for cross-domain keys. 


cross-domain. In SNA, pertaining to control of 
resources involving more than one domain. 


cross-domain keys. In SNA, a pair of cryptographic 
keys used by a system services control point (SSCP) to 
encipher the session cryptography key that is sent to 
another SSCP and to decipher the session 
cryptography key that is received from the other SSCP 
during initiation of cross-domain LU-LU sessions that 
use session-level cryptography. Synonymous with 
cross keys. 


cross-domain link. (1) A subarea link connecting two 
subareas that are in different domains. (2) A link phys- 
ically connecting two domains. 


cross-domain network manager (CDNM) session. A 
session between two network managers (NetView or 
NCCF) in separate domains. 


cross-domain resource (CDRSC). A resource owned by 
a cross-domain resource manager (CDRM) in another 
domain but known by the CDRM in this domain by 
network name and associated CDRM. 


cross-domain resource manager (CDRM). In VTAM, 
the function in the system services control point (SSCP) 
that controls initiation and termination of cross-domain 
sessions. 


cross-network. In SNA, pertaining to control or 
resources involving more than one SNA network. 


cross-network LU-LU session. In SNA, a session 
between logical units (LUs) in different networks. 


cross-network session. An LU-LU or SSCP-SSCP 
session whose path traverses more than one SNA 
network. 


CRP. Configuration report program. 
CRV. Cryptography verification. 


cryptographic. Pertaining to the transformation of data 
to conceal its meaning. See also encipher and deci- 
pher. 


cryptographic algorithm. A set of rules that specify the 
mathematical steps required to encipher and decipher 
data. 


cryptographic key. In systems using the Data 
Encryption Standard (DES), a 64-bit value (containing 
56 independent bits and 8 parity bits) provided as input 
to the algorithm in determining the output of the algo- 
rithm. See cross-domain keys, session cryptography 
key, host master key, and secondary logical unit key. 


cryptographic session. In SNA products, an LU-LU 
session in which a function management data (FMD) 
request may be enciphered before it is transmitted and 
deciphered after it is received. Contrast with clear 
session. See required cryptographic session and 


_ Selective cryptographic session. 


cryptographic session key. In SNA, deprecated term 
for session cryptography key. 


cryptography verification (CRV) request. A request unit 
sent by the primary logical unit (PLU) to the secondary 
logical unit (SLU) as part of cryptographic session 
establishment, to allow the SLU to verify that the PLU is 
using the correct cryptographic session key. 


CSP. Communication scanner processor. 


Customer Information Control System (CICS). A 
licensed program that enables transactions entered at 
remote terminals to be processed concurrently by user- 
written application programs. It also includes facilities 
for building, using, and maintaining data bases. 


CWALL. An NCP threshold of buffer availability, below 
which the NCP will accept only high-priority path infor- 
mation units (PIUs). 

DAF. Destination address field. 

DASD conservation option. A NetView installation 


option, available on the VM operating system, that 
allows the NetView program to be installed without the 
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online help facility and hardware monitor data presen- 
tation panels. 


data channel. Synonym for input/output channel. See 
channel. 


data check. An indication that a transmission is faulty. 
For example, in SDLC a frame check sequence (FCS) 
error. 


data circuit-terminating equipment (DCE). (TC97) The 
equipment installed at the user’s premises that pro- 
vides all functions required to establish, maintain, and 
terminate a connection, and the signal conversion and 
coding between the data terminal equipment (DTE) and 
the line. The DCE may be separate equipment or an 
integral part of other equipment. 


data-encrypting key. A key used to encipher and deci- 
pher data transmitted in a cryptographic session. Con- 
trast with key-encrypting key. See session 
cryptography key. 


Data Encryption Standard (DES) algorithm. A 
cryptographic algorithm designed to encipher and deci- 
pher data using a 64-bit cryptographic key, as specified 
in the Federal Information Processing Standard Publi- 
cation 46, January 15, 1977. 


data flow control (DFC). In SNA, a request/response 
unit (RU) category used for requests and responses 
exchanged between the data flow control layer in one 
half-session and the data flow control layer in the 
session partner. 


data flow control (DFC) layer. In SNA, the layer within 
a half-session that (1) controls whether the half-session 
can send, receive, or concurrently send and receive 
request units (RUs); (2) groups related RUs into RU 
chains; (3) delimits transactions via the bracket pro- 
tocol; (4) controls the interlocking of requests and 
responses in accordance with control modes specified 
at session activation; (5) generates sequence numbers; 
and (6) correlates requests and responses. 


data flow control (DFC) protocol. In SNA, the 
sequencing rules for requests and responses by which 
network addressable units (NAUs) in a session coordi- 
nate and control data transfer and other operations. 
For example, see bracket protocol. 


data flow synchronous (DFSYN) response. In VIAM, a 
normal-flow response that is treated as a normal-flow 
request so that it may be received in sequence with 
normal-flow requests. 


data host. Synonym for data host node. Contrast with 
communication management configuration host. 


data host node. In a communication management con- 


figuration, a type 5 host node that is dedicated to proc- 
essing applications and does not control network 
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resources, except for its channel-attached or communi- 
cation adapter-attached devices. Synonymous with 
data host. Contrast with communication management 
configuration host node. 


data link. In SNA, synonym for /ink. 


data link control (DLC) layer. In SNA, the layer that 
consists of the link stations that schedule data transfer 
over a transmission medium connecting two nodes and 
perform error control for the link connection. Examples 
of data link control are SDLC for serial-by-bit link con- 
nection and data link control for the System/370 
channel. 


data link control protocol. In SNA, a set of rules used 
by two nodes on a data link to accomplish an orderly 
exchange of information. Synonymous with /ine 
control. 


data services command processor (DSCP). A compo- 
nent that structures a request for recording and 
retrieving data in the application program’s data base 
and for soliciting data from a device in the network. 


data services manager (DSM). A function in NetView 
that provides VSAM services for data storage and 
retrieval. 


data services request block (DSRB). The control block 
in NetView that contains information that a data ser- 
vices command processor (DSCP) needs to communi- 
cate with the data services task (DST). 


data services task (DST). The NetView subtask that 
gathers, records, and manages data in a VSAM file 
and/or a network device that contains network manage- 
ment information. 


data terminal equipment (DTE). (TC97) That part of a 
data station that serves as a data source, data link, or 
both, and provides for the data communication control 
function according to protocols. 


data traffic reset state. The state a session usually 
enters before the start data traffic state, and after Clear 
or Bind Session (if cryptography verification (CRV) is 
used). While a session is in this state, requests and 
responses for data and data flow control cannot be 
sent. Only certain session control requests can be 
sent. See also command. 


data types. In the NetView program, a concept to 
describe the organization of panels. Data types are 
defined as alerts, events, and statistics. Data types are 
combined with resource types and display types to 
describe NetView’s display organization. See also 
display types and resource types. 


DBCS. Double-byte character set. 


DCE. Data circuit-terminating equipment. 


deactivate. To take a resource of a node out of service, 
rendering it inoperable, or to place it in a state in which 
it cannot perform the functions for which it was 
designed. Contrast with activate. 


deallocate. A logical unit (LU) 6.2 application program 
interface (API) verb that terminates a conversation, 
thereby freeing the session for a future conversation. 
Contrast with allocate. 


decipher. To convert enciphered data into clear data. 
Contrast with encipher. Synonymous with decrypt. 


decrypt. To convert encrypted data into clear data. 
Contrast with encrypt. Synonym for decipher. 


decryption. The unscrambling of data using an algo- 
rithm which works under the control of a key. The key 
allows data to be protected even when the algorithm is 
unknown. Data is unscrambled after transmission. 
Contrast with encryption. 


default code point. In alerts, a 2-byte code point in 
which the first byte indexes text providing a high-level 
description of a type of condition. The second byte is 
zero. See replacement code point. 


default SSCP list. A list of system services control 
points (SSCPs), either in VTAM’s network or another 
network, that can be used when no predefined cross- 
domain resource (CDRSC) or name translation function 
is provided specifying an LU’s owning cross-domain 
resource manager (CDRM). This list is filed as a part of 
an adjacent SSCP table in the VTAM definition library. 


default SSCP selection. A VTAM function that selects a 
set of one or more system services control points 
(SSCPs) to which a session request can be routed when 
there is no predefined cross-domain resource (CDRSC) 
or name translation function provided that specifies an 
LU’s owning cross-domain resource manager (CDRM). 
See also default SSCP list. 


definite response (DR). In SNA, a value in the form-of- 
response-requested field of the request header. The 
value directs the receiver of the request to return a 
response unconditionally, whether positive or negative, 
to that request. Contrast with exception response and 
no response. 


definition statement. (1) In VTAM, the statement that 
describes an element of the network. (2) In NCP, a 
type of instruction that defines a resource to the NCP. 
See Figure X-1, Figure X-2, and Figure X-3. See also 
macroinstruction. 


operands 
suboperands suboperands 
START A,(B,C), KEYWORDI=D, KEYWORD2=(E,F) 
statement positional keyword 
identifier operands operands 


statement 


Figure X-1. Example of a Language Statement 


definition statement 


suboperands 
BUILD CA=(ca0[,cal][,ca2][,ca3]) 
definition keyword 
statement operand 
identifier 


Figure X-2. NCP Examples 


definition keyword operand 

statement 

identifier suboperands 
PU DISCNT=([YES|NO][,F|NF]) 


definition statement 


VARY NET,ACT, ID=name ,RNAME=(namel,...,name13) 
operator positional suboperands 
command operands 
operator 


operands 


operator command 


Figure X-3. VTAM Examples 


definition statement identifier. A specific character 
string that identifies the purpose of a definition state- 
ment. 


delay compensation. In CCP, a responding arrange- 
ment by which the IBM 3710 Network Controller 
answers for a receiving station. 


delayed-request mode. In SNA, an operational mode in 
which the sender may continue sending request units 
on the normal flow after sending a definite-response 
request chain on that flow, without waiting to receive 
the response to that chain. Contrast with immediate- 
request mode. 
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delayed alert. An alert reporting a condition that pre- 
vented the sender from sending the alert to a control 
point. The fact that a delayed alert is sent implies that 
the condition it reports is no longer impacting avail- 
ability. See held alert. 


delayed-response mode. In SNA, an operational mode 
in which the receiver of normal-flow request units can 
return responses to the sender in a sequence different 
from that in which the corresponding request units 
(RUs) were sent. An exception is the response to a 
CHASE request. Contrast with immediate-response 
mode. 


DELTA disk. The virtual disk in a VM operating system 
that contains program temporary fixes (PTFs) that have 
been installed but not merged. See BASE disk, MERGE 
disk, RUN disk, and ZAP disk. 


dependent LU. Any logical unit (LU) that receives an 
ACTLU over a link. Such LUs can act only as sec- 
ondary logical units (SLUs) and can have only one 
LU-LU session at a time. Contrast with independent 
LU. 


DES. Data Encryption Standard. 


designated gateway SSCP. A gateway system services 
control point (SSCP) designated to perform all the 
gateway control functions during LU-LU session setup. 


destination address field (DAF). In SNA, a field ina 
FIDO or FID1 transmission header that contains the 
network address of the destination. 


destination logical unit (DLU). The logical unit to which 
data is to be sent. Contrast with origin logical unit 
(OLU). 


destination subarea field (DSAF). In SNA, a field ina 
FID4 transmission header that contains a subarea 
address, which combined with the element address in 
the destination element field gives the complete 
network address of the destination network address- 
able unit (NAU). Contrast with origin subarea field. 


device control character. * (ISO) A contro! character 
used for the control of ancillary devices associated with 
a data processing system or data communication 
system, for example, for switching such devices on or 
off. 


detailed data. Short strings of textual data transported 
in a network management vector transport (NMVT) and 
displayed, without any interpretation or translation, by 
a problem management focal-point program. 


device-type logical unit. In VTAM, a logical unit that 
has a session limit of 1 and usually acts as the sec- 
ondary end of a session. It is typically a logical unit 
(LU) in an SNA terminal, such as a 3270. It could be the 
primary end of a session, for example, the logical unit 
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representing the Network Routing Facility (NRF) logical 
unit. 


DFC. Data flow control. 
DFSYN response. Data flow synchronous response. 


dial-in. Refers to the direction in which a switched con- 
nection is requested by any node or terminal other than 
the receiving host or an NCP. 


dial-out. Refers to the direction in which a switched 
connection is requested by a host or an NCP. 


direct access storage device (DASD). A device in 
which the access time is effectively independent of the 
location of the data. For example, a disk. 


direct activation. In VTAM, the activation of a resource 
as a result of an activation command specifically 
naming the resource. See automatic activation. Con- 
trast with indirect activation. 


direct deactivation. In VTAM, the deactivation of a 
resource as a result of a deactivation command specif- 
ically naming the resource. See also automatic deacti- 
vation. Contrast with indirect deactivation. 


directory. In VM, a control program (CP) disk that 
defines each virtual machine’s normal configuration. 


disabled. In VTAM, pertaining to a logical unit (LU) that 
has indicated to its system services control point 
(SSCP) that it is temporarily not ready to establish 
LU-LU sessions. An initiate request for a session with 
a disabled logical unit (LU) can specify that the session 
be queued by the SSCP until the LU becomes enabled. 
The LU can separately indicate whether this applies to 
its ability to act as a primary logical unit (PLU) or a sec- 
ondary logical unit (SLU). See also enabled and inhib- 
ited. 


disconnection. The termination of a physical con- 
nection. 


discontiguous shared segment. An area of virtual 
storage outside the address range of a virtual machine. 
It can contain read-only data or reentrant code. It con- 
nects discontiguous segments to a virtual machine’s 
address space so programs can be fetched. 


Disk Operating System (DOS). Software for the PC that 
controls the execution of programs. Its full name is the 
IBM Personal Computer Disk Operating System. 


display. (1) To present information for viewing, usually 
on a terminal screen or a hard-copy device. (2) A 
device or medium on which information is presented, 
such as a terminal screen. (3) Deprecated term for 
panel. 


display levels. Synonym for display types. 


display types. In NetView, a concept to describe the 
organization of panels. Display types are defined as 
total, most recent, user action, and detail. Display 
types are combined with resource types and data types 
to describe NetView’s panel organization. See data 
types and resource types. Synonymous with display 
levels. 


DLC. Data link control. 
DLU. Destination logical unit. 


domain. (i) An access method, its application pro- 
grams, communication controllers, connecting lines, 


modems, and attached terminals. (2) In SNA, a system 


services control point (SSCP) and the physical units 


(PUs), logical units (LUs), links, link stations, and all the 


associated resources that the SSCP has the ability to 
control by means of activation requests and deacti- 
vation requests. See system services control point 
domain and type 2.1 node control point domain. See 
also single-domain network and multiple-domain 
network 


domain operator. !n a multiple-domain network, the 
person or program that controls the operation of the 
resources controlled by one system services control 
point. Contrast with network operator (2). 


DOS. Disk Operating System. 


DOS partition. In the NetView/PC program, a separate 
area of memory in which NetView/PC programs and 
other DOS programs can be serially executed. 


double-byte character set (DBCS). A set of graphic 
characters where two bytes are used to represent the 
character set of such languages as Chinese and 
Japanese. The shift-in (S!} and shift-out (SO) control! 
codes are used when DBCS is mixed with standard 
one-byte character sets. 


double recording. In the NetView program. refers to 
the recording of certain individual events under two 
resource levels. 


downstream. In the direction of data flow from the host 
to the end user. Contrast with upstream. 


downstream device. For the IBM 3710 Network Con- 
troller, a device located in a network such thai the 3710 
is positioned between the device and a host. A display 
terminal downstream from the 3710 is an example of a 
downstream device. Contrast with upstream device. 


cownstream line. For the IBM 3710 Network Controller, 


a telecommunication line attaching a downstream 
device to a 3710. Contrast with upstream line. 


Downstream Load Utility (DSLU). A licensed program 
that uses the communication network management 
(CNM) interface to support the load requirements of 


certain type 2 physical units, such as the IBM 3644 
Automatic Data Unit and the IBM 8775 Display Ter- 
minal. 


DR. (1) In NCP and CCP, dynamic reconfiguration. 
(2) In SNA, definite response. 


draining. For logical unit (LU) 6.2, the process of hon- 
oring pending allocation requesis before deactivating 
sessions with a partner LU. 


DRDS. Dynamic reconfiguration data set. 
DSAF. Destination subarea field. 

DSCP. Data services command processor. 
DSM. Data services manager. 

DST. Data services task. 

DTE. Data terminal equipment. 


dump. (1) Computer printout of storage. (2) To write 
the contents of all or part of storage to an external 
medium as a safeguard against errors or in connection 
with debugging. (3) (ISO) Data that have been dumped. 


duplex. * In data communication, pertaining to a simul- 
taneous two-way independent transmission in both 
directions. Synonymous with full duplex. Contrast with 
half duplex. 


dynamic LPDA. A function enabling a NetView applica- 
tion to set or query the Link Problem Determination Aid 
(LPDA) status for a link or station. 


dynamic path update. The process of changing the 
network path for sending information without regener- 
ating complete configuration tables. 


dynamic reconfiguration (DR). The process of changing 
the network configuration (peripheral PUs and LUs) 
without regenerating complete configuration tables. 


dynamic reconfiguration data set (DRDS). In VTAM, a 
data set used for storing definition data that can be 
applied to a generated communication controller con- 
figuration at the operator's request. A dynamic recon- 
figuration data set can be used to dynamically add PUs 
and LUs, delete PUs and LUs, and move PUs. It is acti- 
vated with the VARY DRDS operator command. See 
also dynamic reconfiguration. 


dynamic threshold alteration. The process that allows 
a network operator to dynamically change the traffic 
count and temporary error threshold values associated 
with SDLC and BSC devices in communication control- 
lers and network controllers. 


dynamic threshold query. The process that allows a 
network operator to query the current settings of a 
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traffic count or temporary error threshold value associ- 
ated with an SDLC or BSC device in a communication 
controller or network controller. 


EBCDIC. * Extended binary-coded decimal interchange 
code. A coded character set consisting of 8-bit coded 
characters. 


ECB. Event control block. 


echo. The return of characters to the originating SS 
device to verify that a message was sent correctly. 


echo check. A check to determine the correctness of 
the transmission of data in which the received data are 
returned to the source for comparison with the ori- 
ginally transmitted data. 


ECL. Electronic cabling link. 
ED. Enciphered data. 


EIA. Electronic Industries Association. Provides inter- 
face standards for electrical and electronic equipment. 


element. (1) A field in the network address. (2) The 
particular resource within a subarea identified by the 
element address. See also subarea. 


element address. In SNA, a value in the element 
address field of the network address identifying a spe- 
cific resource within a subarea. See subarea address. 


emulation mode. The function of a network control 
program that enables it to perform activities equivalent 
to those performed by a transmission control unit. 
Contrast with network control mode. 


Emulation Program (EP). An IBM control program that 
allows a channel-attached 3705 or 3725 communication 
controller to emulate the functions of an IBM 2701 Data 
Adapter Unit, an IBM 2702 Transmission Control, or an 
IBM 2703 Transmission Control. See also network 
control program. 


enabled. In VTAM, pertaining to a logical unit (LU) that 
has indicated to its system services control point 


(SSCP) that it is now ready to establish LU-LU sessions. 


The LU can separately indicate whether this prevents it 
from acting as a primary logical unit (PLU) or as a sec- 
ondary logical unit (SLU). See also disabled and inhib- 
ited. 


encipher. (1) To scramble data or convert it, before 
transmission, to a secret code that masks the meaning 
of the data to any unauthorized recipient. (2) In VTAM, 
to convert clear data into enciphered data. Contrast 
with decipher. Synonymous with encrypt. 


enciphered data (ED). Data whose meaning is con- 
cealed from unauthorized users. 
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encrypt. Synonym for encipher. 


encryption. The scrambling or encoding of data using 
an algorithm which works under the control of a key. 
The key allows data to be protected even when the 
algorithm is unknown. Data is scrambled prior to 
transmission. Contrast with decryption. 


end bracket. In SNA, the value (binary 1) of the end 
bracket indicator in the request header (RH) of the first 
request of the last chain of a bracket; the value denotes 
the end of the bracket. Contrast with begin bracket. 
See also bracket. 


end-of-transmission (EOT). The specific character, or 
sequence of characters, that indicates no more data. 


end-of-transmission (EOT) handshaking. When a 3710 
sends EOT characters over an idle line and waits for 
return characters. If no EOT response is returned, the 
3710 breaks the session. 


end node. A type 2.1 node that does not provide any 
intermediate routing or session services to any other 
node. For example, APPC/PC is an end node. See 
composite end node, node, and type 2.1 node. 


end node control point. A control point (CP) within a 
type 2.1 peripheral node that provides its own config- 
uration, session, and management services with assist- 
ance from its controlling network node control point. 
For example, the control point of APPC/PC is an end 
node control point. 


end user. In SNA, the ultimate source or destination of 
application data flowing through an SNA network. An 
end user may be an application program or a terminal 
operator. 


end-user verification. For logical unit (LU) 6.2, 
checking the identification of end-users by means of 
identifiers and passwords on attach function- 
management headers (FMHs). See partner-LU verifica- 
tion. See also conversation-level security. 


entry point. An SNA node that provides distributed 
network management support. It may be a type 2, type 
2.1, type 4, or type 5 node. It sends SNA-formatted 
network management data about itself and the 
resources it controls to a focal point for centralized 
processing, and it receives and executes focal point ini- 
tiated commands to manage and control its resources. 


EOT. End-of-transmission. 
EP. Emulation Program. 
ER. (1) Explicit route. (2) Exception response. © 


error-to-traffic (E/T). The number of temporary errors 
compared to the traffic associated with a resource. 


ESTAE. Extended specify task abnormal exit. 
E/T. Error-to-traffic. 


event. (1) In the NetView program, a record indicating 
irregularities of operation in physical elements of a 
network. (2) An occurrence of significance to a task; 
typically, the completion of an asynchronous operation, 
such as an input/output operation. 


event control block (ECB). A control block used to rep- 
resent the status of an event. 


exception request (EXR). In SNA, a request that 
replaces another message unit in which an error has 
been detected. 


exception response (ER). In SNA, a value in the form- 
of-response-requested field of a request header (RH). 
An exception response is sent only if a request is unac- 
ceptable as received or cannot be processed. Contrast 
with definite response and no response. See also neg- 
ative response. 


exchange identification (XID). A data link control 
command and response passed between adjacent 
nodes that allows the two nodes to exchange identifica- 
tion and other information necessary for operation over 
the data link. 


EXEC. In a VM operating system, a user-written 
command file that contains CMS commands, other 
user-written commands, and execution control state- 
ments, such as branches. 


exit list (EXLST). In VSAM and VTAM, a control block 
that contains the addresses of routines that receive 
control when specified events occur during execution; 
for example, routines that handle session- 
establishment request processing or !/O errors. 


exit routine. Any of several types of special-purpose 
user-written routines. See accounting exit routine, 
authorization exit routine, logon-interpret routine, 
virtual route selection exit routine, EXLST exit routine, 
and APL exit routine. 


EXLST exit routine. In VTAM, a routine whose address 
has been placed in an exit list (EXLST) control block. 
The addresses are placed there with the EXLST macro- 
instruction, and the routines are named according to 
their corresponding operand; hence DFASY exit 
routine, TPEND exit routine, RELREQ exit routine, and 
so forth. All exit list routines are coded by the VTAM 
application programmer. Contrast with RPL exit 
routine. 


expedited flow. In SNA, a data flow designated in the 
transmission header (TH) that is used to carry network 
control, session control, and various data flow control 
request/response units (RUs); the expedited flow is 
separate from the normal flow (which carries primarily 


end-user data) and can be used for commands that 
affect the normal flow. Contrast with normal flow. 


explicit command. In the NetView program, using a 
direct command to start an operation or to request 
information instead of stepping through the panel hier- 
archy to do so. 


explicit route (ER). In SNA, the path control network 
elements, including a specific set of one or more trans- 
mission groups, that connect two subarea nodes. An 
explicit route is identified by an origin subarea 
address, a destination subarea address, an explicit 
route number, and a reverse explicit route number. 
Contrast with virtual route (VR). See also path and 
route extension. 


explicit route length. In SNA, the number of trans- 
mission groups in an explicit route. 


EXR. Exception request. 


extended network addressing. The network addressing 
system that splits the address into an 8-bit subarea and 
a 15-bit element portion. The subarea portion of the 
address is used to address host processors or commu- 
nication controllers. The element portion is used to 
permit processors or controllers to address resources. 


extended recovery facility (XRF). Software designed to 
minimize the effect of failures in MVS, VTAM, the host 
processor, or IMS/VS on sessions between IMS/VS and 
designated terminals. It provides an alternate sub- 
system to take over failing sessions. 


extended specify task abnormal exit (ESTAE). An MVS 
macroinstruction that provides recovery capability and 
gives control to the user-specified exit routine for proc- 
essing, diagnosing an abend, or specifying a retry 
address. 


fanout. A modem feature that permits up to four con- 
trollers to be attached to one modem. See also failing. 


FASTRUN. One of several options available with the 
NCP/EP Definition Facility (NDF) that indicates only the 
syntax is to be checked in generation definition state- 
ments. 


FDX. Full duplex. 


feature. A particular part of an IBM product that a cus- 
tomer can order separately. 


feedback information. In VTAM, information that is 
placed in certain RPL fields when an RPL-based macro- 
instruction is completed. 


FIC. First-in-chain. 


FID. Format identification. 
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field-formatted. Pertaining to a request or response 
that is encoded into fields; each having a specified 
format such as binary codes, bit-significant flags, and 
symbolic names. Contrast with character-coded. 


field-formatted request. In SNA, a request that is 
encoded into fields, each having a specified format 
such as binary codes, binary counts, bit-significant 
flags, and symbolic names; a format indicator in the 
request/response header (RH) for the request is set to 
zero. Contrast with character-coded. 


filter. In the NetView program, a function that limits the 
data that is to be recorded on the data base and dis- 
played at the terminal. See recording filter and viewing 
filter. 


first-in-chain (FIC). A request unit (RU) whose request 
header (RH) begin chain indicator is on and whose RH 
end chain indicator is off. See also RU chain. 


first speaker. In SNA, the LU-LU half-session defined at 
session activation as: (1) able to begin a bracket 
without requesting permission from the other LU-LU 
half-session to do so, and (2) winning contention if both 
half-sessions attempt to begin a bracket simultane- 
ously. Contrast with bidder. See also bracket protocol. 


flow control. In SNA, the process of managing the rate 
at which data traffic passes between components of the 
network. The purpose of flow control is to optimize the , 
rate of flow of message units, with minimum congestion 
in the network; that is, to neither overflow the buffers at 
the receiver or at intermediate routing nodes, nor leave 
the receiver waiting for more message units. See also 
adaptive session-level pacing, pacing, session-level 
pacing, and virtual route pacing. 


flushing. In logical unit (LU) 6.2, the process of sending 
through the network all remaining buffered data gener- 
ated by a transaction program. The transaction 
program issues the flush verb to begin the process. It 
also occurs if the network operator issues the 
command. 


FMD. Function management data. 
FMH. Function management header. 


focal point. An entry point that provides centralized 
management and control for other entry points for one 
or more network management categories. 


format identification (FID) field. In SNA, a field in each 
transmission header (TH) that indicates the format of 
the TH; that is, the presence or absence of certain 
fields. TH formats differ in accordance with the types of 
nodes between which they pass. The six FID types are: 


FIDO, used for traffic involving non-SNA devices 
between adjacent subarea nodes when either or 
both nodes do not support explicit route and virtual 
route protocols. 
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FID1, used for traffic between adjacent subarea 
nodes when either or both nodes do not support 
explicit route and virtual route protocols. 


FID2, used for traffic between a subarea node and 
an adjacent type 2 peripheral node. 


FID3, used for traffic between a subarea node and 
an adjacent type 1 peripheral node. 


FID4, used for traffic between adjacent subarea 
nodes when both nodes support explicit route and 
virtual route protocols. 


FIDF, used for certain commands (for example, for 
transmission group control) sent between adjacent 
subarea nodes when both nodes support explicit 
route and virtual route protocols. 


formatted system services. A portion of VTAM that pro- 
vides certain system services as a result of receiving a 
field-formatted command, such as an Initiate or Termi- 
nate command. Contrast with unformatted system ser- 
vices (USS). See also field-formatted. 


frame. (1) The unit of transmission in some local area 
networks, including the IBM Token-Ring Network. It 
includes delimiters, control characters, information, 
and checking characters. (2) In SDLC, the vehicle for 
every command, every response, and all information 
that is transmitted using SDLC procedures. 


full duplex (FDX). Synonym for duplex. 


full-screen mode. A form of panel presentation in 
NetView where the contents of an entire terminal 
screen can be displayed at once. Full-screen mode can 
be used for fill-in-the-blanks prompting. Contrast with 
line mode. 


function management data (FMD). In SNA, a request 
unit (RU) category used for end-user data exchanged 
between logical units (LUs) and for requests and 
responses exchanged between network services com- 
ponents of LUs, physical units (PUs), and system ser- 
vices control points (SSCPs). 


function management header (FMH). In SNA, one or 
more headers, optionally present in the leading request 
units (RUs) of an RU chain, that allow one half-session 
in an LU-LU session to: (1) select a destination at the 
session partner and control the way in which the end- 
user data it sends is handled at the destination, (2) 
change the destination or the characteristics of the data 
during the session, and (3) transmit between session 
partners status or user information about the destina- 
tion (for example, a program or device). Function man- 
agement headers (FMHs) can be used on LU-LU types 
1, 4, and 6.2. | 


function management profile. In SNA, a specification of 
various data flow control protocols (such as RU chains 
and data flow control requests) and function manage- 


ment data (FMD) options (such as use of function man- 
agement headers, compression, and alternate codes) 
supported for a particular session. Each function man- 
agement profile is identified by a number. 


gateway. The combination of machines and programs 
that provide address translation, name translation, and 
system services control point (SSCP) rerouting 
between independent SNA networks to allow those net- 
works to communicate. A gateway consists of one 
gateway NCP and at least one gateway SSCP. 


gateway control functions. Functions performed by a 
gateway system services control point (SSCP) in con- 
junction with the gateway NCP to assign alias network 
address pairs for LU-LU sessions, assign virtual routes 
for the LU-LU sessions in adjacent networks, and trans- 
late network names within BIND RUs. 


gateway host. A host node that contains a gateway 
system services control point (SSCP). 


gateway NCP. An NCP that performs address trans- 
lation to allow cross-network session traffic. The 
gateway NCP connects two or more independent SNA 
networks. Synonymous with gateway node. 


gateway node. Synonym for gateway NCP. 


gateway SSCP. An SSCP that is capabie of cross- 
network session initiation, termination, takedown, and 
session outage notification. A gateway SSCP is in 
session with the gateway NCP; it provides network 
name translation and assists the gateway NCP in 
setting up alias network addresses for cross-network 
sessions. 


gateway-capablie host. A host node that has a defined 
NETID and SSCPNAME but does not perform gateway 
control functions, such as cross-network session initi- 
ation and termination. 


GCS. Group control system. 


generalized path information unit trace (GPT). A record 
of the flow of path information units (PIUs) exchanged 
between the network control program and its attached 
resources. PIU trace records consist of up to 44 bytes 
of transmission header (TH), request/response header 
(RH), and request/response unit (RU) data. 


generation. The process of assembling and link editing 
definition statements so that resources can be identi- 
fied to all the necessary programs in a network. 


generation definition. The definition statement of a 
resource used in generating a program. 


generic alert. Encoded alert information that uses code 
points (defined by IBM and possibly customized by 
users or application programs) stored at an alert 
receiver, such as the NetView program. 


generic unbind. Synonym for session deactivation 
request. 


gigabyte. One billion (10°) bytes. 
GPT. Generalized path information unit trace. 


group. In the NetView/PC program, to identify a set of 
application programs that are to run concurrently. 


group control system (GCS). A component of VM that 
provides multi-programming and shared memory 
support to virtual machines. It is a saved system 
intended for use with SNA products. 


group control system group. A group of virtual 
machines that share common storage and load the 
same saved-VM system through a control program (CP) 
command or directory entry. 


half-duplex. * In data communication, pertaining to an 
alternate, one way at a time, independent transmission. 
Contrast with duplex. 


half-session. In SNA, a component that provides func- 
tion management data (FMD) services, data flow 
control, and transmission control for one of the ses- 
sions of a network addressable unit (NAU). See also 
primary half-session and secondary half-session. 


hard copy. A printed copy of machine output in a visu- 
ally readable form; for example, printed reports, 
listings, documents, summaries, or network logs. 


hard-copy task (HCT). The NetView subtask that con- 
trols the passage of data between NetView and the 
hard-copy device. 


hardware monitor. The component of the NetView 
program that helps identify network problems, such as 
hardware, software, and microcode, from a central 
control point using interactive display techniques. 


HCF. Host Command Facility. 

HCT. Hard-copy task. 

held alert. An alert that an alert sender was unable to 
send to a control point immediately. The alert condi- 
tion it reports may or may not still be impacting avail- 


ability. See also delayed alert. 


help desk operator. A person who receives questions 
or problem reports from network users. 


help panel. An online display that tells you how to use 
a command or another aspect of a product. See task 
panel. 


High Performance Option (HPQ). A licensed program 
that is an extension of VM/SP. It provides performance 
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and operation enhancements for large system environ- 
ments. 


hierarchy. In the NetView program, the resource types, 
display types, and data types that make up the organ- 
ization, or levels, in a network. 


Host Command Facility (HCF). An IBM licensed 
program that enables a user at a System/370 terminal 
to access applications in systems such as the 8100 or 
System/36. 


host LU. An SNA logical unit located in a host 
processor, for example, a VTAM application program. 
Contrast with peripheral LU. 


host master key. In SNA, deprecated term for master 
cryptography key. 


host node. A node providing an application program 
interface (API) and a common application interface. 
See boundary node, node, peripheral node, subarea 
host node, and subarea node. See also boundary func- 
tion and node type. 


host processor. (1) (TC97) A processor that controls 
all or part of a user application network. (2) Ina 
network, the processing unit in which the data commu- 
nication access method resides. 


HPO. High Performance Option. 


hung terminal. A terminal to which a session is dis- 
rupted and that cannot send or receive commands. 


ICV. Initial chaining value. 


idle character. (1) (CCITT/ITU) A control character that 
is sent when there is no information to be sent. (2) A 
character transmitted on a communication line that 
does not print or punch to the output component of the 
accepting terminal. 


il-frame. A DLC frame type for transmitting data. Other 
DLC frame types are for control, status, and supervi- 
sory information. 


immediate command. In the NetView program, a 
command (such as GO, CANCEL, or RESET) that can be 
executed while a regular command is being processed. 


immediate-request mode. In SNA, an operational mode 
in which the sender stops sending request units (RUs) 
on a given flow (normal or expedited) after sending a 
definite-response request chain on that flow until that 
chain has been responded to. Contrast with delayed- 
request mode. See also immediate-response mode. 


immediate-response mode. In SNA, an operational 
mode in which the receiver responds to request units 
(RUs) on a given normal flow in the order it receives 
them; that is, in a first-in, first-out sequence. Contrast 
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with delayed-response mode. See also immediate- 
request mode. 


IMR. Intensive mode recording. 


IMS. Information Management System/Virtual Storage. 
Synonymous with /MS/VS. 


IMS/VS. Information Management System/Virtual 
Storage. Synonym for /MS. 


inactive. Describes the state of a resource that has not 
been activated or for which the VARY INACT command 
has been issued. Contrast with active. See also inop- 

erative. 


independent LU. A logical unit (LU) that does not 
receive an ACTLU over a link. Such LUs can act as 
primary logical units (PLUs) or secondary logical units 
(SLUs) and can have one or more LU-LU sessions ata 
time. Contrast with dependent LU. 


indicated resource. The SNA or non-SNA entity most 
closely associated with the alert condition. 


indirect activation. In VTAM, the activation of a lower- 
level resource of the resource hierarchy as a result of 
SCOPE or ISTATUS specifications related to an acti- 
vation command naming a higher-level resource. Con- 
trast with direct activation. 


indirect deactivation. In VTAM, the deactivation of a 
lower-level resource of the resource hierarchy as a 
result of a deactivation command naming a higher-level 
resource. Contrast with direct deactivation. 


information/Management. A feature of the 
Information/System licensed program that provides 
interactive systems management applications for 
problem, change, and configuration management. 


information management data base. A system man- 
agement tool that helps collect, organize, and keep 
track of problems and their resolutions. 


Information Management System (IMS). A general 
purpose system whose full name is Information Man- 
agement System/Virtual Storage (IMS/VS). It enhances 
the capabilities of OS/VS for batch processing and tele- 
communication and allows users to access a computer- 
maintained data base through remote terminals. 


information/System. An interactive retrieval program 
with related utilities designed to provide systems pro- 
grammers with keyword access to selected technical 
information contained in either of its companion pro- 
ducts, Information/MVS or Information/VM-VSE. 


inhibited. In VTAM, pertaining to a logical unit (LU) that 
has indicated to its system services control point 
(SSCP) that it is not ready to establish LU-LU sessions. 
An initiate request for a session with an inhibited LU 


will be rejected by the SSCP. The LU can separately 
indicate whether this applies to its ability to act as a 
primary logical unit (PLU) or as a secondary logical 
unit (SLU). See also enabled and disabled. 


initial chaining value (ICV). An 8-byte pseudo-random 
number used to verify that both ends of a session with 
cryptography have the same session cryptography key. 
The initial chaining value is also used as input to the 
Data Encryption Standard (DES) algorithm to encipher 
or decipher data in a session with cryptography. Syn- 
onymous with session seed. 


initiate. A network services request sent from a logical 
unit (LU) to a system services control point (SSCP) 
requesting that an LU-LU session be established. 


inline exit routine. In VTAM, a SYNAD or LERAD exit 
routine. Contrast with asynchronous exit routine. 


inoperative. The condition of a resource that has been 
active, but is not. The resource may have failed, 
received an INOP request, or is suspended while a 
reactivate command is being processed. See also 
inactive. 


input/output channel. (1) (ISO). In a data processing 
system, a functional unit that handles the transfer of 
data between internal and peripheral equipment. (2) In 
a computing system, a functional unit, controlled by a 
processor, that handles the transfer of data between 
processor storage and local peripheral devices. Syn- 
onymous with data channel. See channel. See also 
link. 


installation exit routine. In VTAM, a user-written exit 
routine that can perform functions related to initiation 
and termination of sessions and is run as part of VTAM 
rather than as part of an application program. Exam- 
ples are the accounting, authorization, logon-interpret, 
and virtual route selection exit routines. Contrast with 
application program exit routine. 


intensive mode recording (IMR). An NCP function that 
forces recording of temporary errors for a specified 
resource. 


interactive problem control system (IPCS). A VM 
facility for diagnosing problems, and managing 

_ problem information and status. IPCS is the principal 
means for diagnosing virtual machine dumps. 


interactive System Productivity Facility (ISPF). An IBM 
licensed program that serves as a full-screen editor 
and dialogue manager. Used for writing application 
programs, it provides a means of generating standard 
screen panels and interactive dialogues between the 
application programmer and terminal user. 


interconnected networks. SNA networks connected by 
gateways. 


interconnection. See SNA network interconnection. 


interface. * A shared boundary. An interface might be 
a hardware component to link two devices or it might 
be a portion of storage or registers accessed by two or 
more computer programs. 


intermediate routing function (IRF). In SNA, a path 
control capability in a subarea node that receives and 
routes path information units (PIUs) that neither origi- 
nate in nor are destined for network addressable units 
(NAUs) in the subarea. See also boundary function. 


intermediate routing node (IRN). In SNA, a subarea 
node with intermediate routing function. 


intermediate SSCP. An SSCP along a session initiation 
path that owns neither of the LUs involved in a cross- 
network LU-LU session. 


interpret table. In VTAM, an installation-defined corre- 
lation list that translates an argument into a string of 
eight characters. Interpret tables can be used to trans- 
late logon data into the name of an application program 
for which the logon is intended. 


inter-user communication vehicle (IUCV). A VM facility 
for passing data between virtual machines and VM 
components. 

IPCS. Interactive problem control system. 

IRF. Intermediate routing function. 

IRN. Intermediate routing node. 

ISPF. Interactive System Productivity Facility. 
ISTATUS. In VTAM and NCP, a definition specification 
method for indicating the initial status of resources. 
See also indirect activation. 

item. In CCP, any of the components, such as commu- 
nication controllers, lines, cluster controllers, and ter- 
minals, that comprise an IBM 3710 Network Controller 
configuration. 

lUCV. Inter-user communication vehicle. 

JCL. Job control language. 

job control language (JCL). * A problem-oriented lan- 
guage designed to express statements in a job that are 
used to identify the job or describe its requirements to 


an operating system. 


Kanji. A character set of symbols used for Japanese 
ideograms. See also double-byte character set. 


Katakana. A character set of symbols used in one of 
the two common Japanese phonetic alphabets. 
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key-encrypting key. A key used in sessions with 
cryptography to encipher and decipher other keys. 
Contrast with data-encrypting key. 


keyword. (1) (TC97) A lexical unit that, in certain con- 
texts, characterizes some language construction. (2) * 
One of the predefined words of an artificial language. 
(3) One of the significant and informative words in a 
title or document that describes the content of that doc- 
ument. (4) A name or symbol that identifies a param- 
eter. (5) A part of a command operand that consists of 
a specific character string (such as DSNAME=). See 
also definition statement and keyword operand. Con- 
trast with positional operand. 


keyword cperand. An operand that consists of a 
keyword followed by one or more values (Such as 
DSNAME = HELLO). See also definition statement. 
Contrast with positiona/ operand. 


keyword parameter. (1) A parameter that consists of a 
keyword followed by one or more values. 


large message performance enhancement outbound 
(LMPEQO). In VTAM, a facility in which VTAM reformats 
function management data (FMD) that exceed the 
maximum request unit (RU) size (as specified in the 
BIND) into a chain or partial chain of RUs. 

last-in-chain (LIC). A request unit (RU) whose request 
header (RH) end chain indicator is on and whose RH 
begin chain indicator is off. See also RU chain. 

LCC. Link connection component. 

LCCM. Link connection component manager. 

LCS. Link connection subsystem. 

LCSM. Link connection subsystem manager. 

LERAD exit routine. A synchronous EXLST exit routine 
that is entered automatically wnen a logic error-is 
detected. 

LIC. (1) Last-in-chain. (2) In NCP, line interface card. 
line. See communication line. 

line mode. A form of screen presentation in which the 
information is presented a iine at a time in the message 
area of the terminal screen. Contrast with full-screen 
mode. 

line control. Synonym for daia link control protocol. 
line group. One or more telecommunication lines of 


the same type that can be activated and deactivated as 
a unit. 
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line probe. A generic term for the IBM 3867 Link Diag- 
nostic Unit, a device that provides the NetView user 
with line quality data and other link information. 


line speed. The number of binary digits that can be 
sent over a telecommunication line in one second, 
expressed in bits per second (bps). 


link. In SNA, the combination of the link connection and 
the link stations joining network nodes; for example: 

(1) a System/370 channel and its associated protocols, 
(2) a serial-by-bit connection under the control of Syn- 
chronous Data Link Control (SDLC). A link connection 
is the physical medium of transmission. A link, 
however, is both logical and physical. Synonymous 
with data link. See Figure X-4 on page X-25. 


link connection. In SNA, the physical equipment pro- 
viding two-way communication between one link station 
and one or more other link stations; for example, a tele- 
communication line ana data circuit terminating equip- 
ment (DCE). 


link connection component (LCC). Components of the 
link that perform functions for the physical layer of the 
link. 


link connection component manager (LCCM). The 
transaction program that manages the configuration of 
the link connection. 


link connection segment. A portion of the configuration 
that is located between two resources listed conseéc- 
utively in the service point command service (SPCS) 
query link configuration request list. 


link connection subsystem (LCS). The sequence of link 
connection components (LCCs) that belong to a link 
connection and are managed by one LCSM. 


link connection subsystem manager (LCSM). The 
transaction program that manages the sequence of link 
connection components (LCCs) that belong to a link 
connection. 


link levei 2 test. See /ink test. 


Link Problem Determination Aid (LPDA). A series of 
testing procedures initiated by NetView that provide 
modem status, attached device status, and the overall 
Quality of a communications link. 


link station. (1) In SNA, the combination of hardware 
and software that allows a node to attach to and 
provide control for a link. (2) In VTAM, a named 
resource within a subarea node that represents 
another subarea node that is attached by a subarea 
link. In the resource hierarchy, the link station is sub- 
ordinate to the subarea link. 


link status (LS). Information maintained by local and 
remote modems. 


Subarea Host Node 
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Figure X-4. Links and Path Controls 


link test. In SNA, a test in which one link station 
returns data received from another link station without 
changing the data in order to test the operation of the 
link. Three tests can be made; they differ in the 
resources that are dedicated during the test. 


LMPEO. Large message performance enhancement 
outbound. 
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LM table. Logical unit mode table. 
load module. (ISO) A program unit that is suitable for 


loading into main storage for execution; it is usually the 
output of a linkage editor. 
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local address. In SNA, an address used in a peripheral 
node in place of an SNA network address and trans- 
formed to or from an SNA network address by the 
boundary function in a subarea node. 


local area network (LAN). (1) A network in which a set 
of devices are connected to one another for communi- 
cation and that can be connected to a larger network. 
See also token ring. (2) A network in which communi- 
cations are limited to a moderately sized geographic 
area such as a single office building, warehouse, or 
Campus, and which do not generally extend across 
public rights-of-way. Contrast with wide area network. 


local-attached. Deprecated term for channel-attached. 


local non-SNA major node. In VTAM, a major node 
whose minor nodes are channel-attached non-SNaA ter- 
minals. 


local PC. In the NetView/PC program, the PC that has 
its keyboard locked by the remote control function. 
Contrast with remote PC. 


local session identification (LSID). In SNA, a field ina 
FID3 (format identification type 3) transmission header 
that contains an indication of the type of session 
(SSCP-PU, SSCP-LU, or LU-LU) and the local address of 
the peripheral logical unit (LU) or physical unit (PU). 


local SNA major node. In VTAM, a major node whose 
minor nodes are channel-attached peripheral nodes. 


logic error. In VTAM, an error condition that results 
from an invalid request; a program logic error. 


logical channel. The path that data travels between the 
origin data terminal equipment (DTE) and an X.25 
network, or between the network and the destination 
DTE. One physical circuit may have many logical chan- 
nels assigned to it. 


logical record. (1) (TC 97) A set of related data or 
words considered to be a record from a logical view- 
point. (2) A unit of information normally pertaining to a 
single subject; a logical record is that user record 
requested of or given to the data management function. 
See also basic conversation. 


logical unit (LU). In SNA, a port through which an end 
user accesses the SNA network and the functions pro- 
vided by system services control points (SSCPs). An 
LU can support at least two sessions—one with an 
SSCP and one with another LU—and may be capable of 
supporting many sessions with other LUs. See also 
network addressable unit (NAU), peripheral LU, phys- 
ical unit (PU), system services control point (SSCP), 
primary logical unit (PLU), and secondary logical unit 
(SLU). 


logical unit mode table. In VTAM, the data structure 
containing information about partner logical units (LUs) 
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and associated mode names. This table corresponds 
to the LU mode table defined for LU 6.2. 


logical unit (LU) services. In SNA, capabilities in a 
logical unit to: (1) receive requests from an end user 
and, in turn, issue requests to the system services 
control point (SSCP) in order to perform the requested 
functions, typically for session initiation; (2) receive 
requests from the SSCP, for example to activate LU-LU 
sessions via Bind Session requests; and (3) provide 
session presentation and other services for LU-LU ses- 
sions. See also physical unit (PU) services. 


logical unit (LU) 6.2. A type of logical unit that supports 
general communication between programs in a distrib- 
uted processing environment. LU 6.2 is characterized 
by (1) a peer relationship between session partners, (2) 
efficient utilization of a session for multiple trans- 
actions, (3) comprehensive end-to-end error proc- 
essing, and (4) a generic application program interface 
(API) consisting of structured verbs that are mapped 
into a product implementation. 


logmode table. Synonym for logon mode table. 
log off. To request that a session be terminated. 


logoff. In VTAM, an unformatted session termination 
request. 


log on. To initiate a session. 


logon. In VTAM, an unformatted session initiation 
request for a session between two logical units. See 
automatic logon and simulated logon. See also 
session-initiation request. 


logon data. In VITAM: (1) The user data portion of a 
field-formatted or unformatted session-initiation 
request. (2) The entire logon sequence or message 
from a logical unit (LU). Synonymous with logon 
message. 


logon message. Synonym for logon data. 


logon mode. In VTAM, a subset of session parameters 
specified in a logon mode table for communication with 
a logical unit. See also session parameters. 


logon mode table. In VTAM, a set of entries for one or 
more logon modes. Each logon mode is identified by a 
logon mode name. Synonymous with /ogmode table. 


logon-interpret routine. In VTAM, an installation exit 
routine, associated with an interpret table entry, that 
translates logon information. It may also verify the 
logon. : 


loop adapter. A feature of the IBM 4300 Processor 
family that allows the attachment of a variety of SNA 
and non-SNA devices. To VTAM, these devices appear 
as channel-attached type 2 physical units (PUs). 


low-entry networking. !n SNA, a capability in type 2.1 
nodes allowing them to be directly attached to one 
another using peer-to-peer protocols and allowing them 
to support multiple and parallel sessions between 
logical units (LUs). 


LPDA. Link Problem Determination Aid. 
LS. Link status. 

LSID. Local session identification. 

LU. Logical unit. 


LU connection test. In SNA products, a diagnostic aid 
that permits a terminal operator to check whether the 
path between a system services control point (SSCP) 
and a logical unit (LU) is operational. 


LU 6.2 session. A session that is initiated by VTAM on 
behalf of a logical unit (LU) 6.2 application program, or 
a session initiated by a remote LU in which the applica- 
tion program specifies that VTAM is to control the 
session by using the APPCCMD macroinstruction. 


LU type. In SNA, the classification of an LU-LU session 
in terms of the specific subset of SNA protocols and 
options supported by the logical units (LUs) for that 
session, namely: 


The mandatory and optional values allowed in the 
session activation request. 


The usage of data stream controls, function man- 
agement headers (FMHs), request unit (RU) param- 
eters, and sense codes. 


Presentation services protocols such as those 
associated with FMH usage. 


LU types 0, 1, 2, 3, 4, 6.1, 6.2, and 7 are defined. 


LU-LU session. In SNA, a session between two logical 
units (LUs) in an SNA network. It provides communi- 
cation between two end users, or between an end user 
and an LU services component. 


LU-LU session type. A deprecated term for LU type. 
LU 6.2. Logical unit 6.2. 


machine check handler (MCH). A feature that analyzes 
errors and attempts recovery by retrying the failing 
instruction, if possible. If retry is unsuccessful, it. 
attempts to correct the malfunction or to isolate the 
affected task. 


macroinstruction. (1) An instruction that when exe- 
cuted causes the execution of a predefined sequence of 
instructions in the same source language. (2) In 
assembler programming, an assembler language state- 
ment that causes the assembler to process a prede- 


fined set of statements called a macro definition. The 
statements normally produced from the macro defi- 
nition replace the macroinstruction in the program. 
See also definition statement. 


main network address. In VTAM, the logical unit (LU) 
network address used for the SSCP-LU session and 
certain LU-LU sessions with the LU. Contrast with aux- 
iliary network address. 


mainline program. In VTAM, that part of the application 
program that issues OPEN and CLOSE macroin- 
structions. 


maintain system history program (MSHP). A program 
that facilitates the process of installing and servicing a 
VSE system. 


maintenance and operator subsystem (MOSS). A sub- 
system of an IBM communication controller, such as 
the 3725 or the 3720, that contains a processor and 
operates independently of the rest of the controller. It 
loads and supervises the controller, runs problem 
determination procedures, and assists in maintaining 
both hardware and software. 


maintenance services. In SNA, one of the types of 
network services in system services control points 
(SSCPs) and physical units (PUs). Maintenance ser- 
vices provide facilities for testing links and nodes and 
for collecting and recording error information. See 
also configuration services, management services, 
network services, and session services. 


major node. In VTAM, a set of resources that can be 
activated and deactivated as a group. See node and 
minor node. 


management services. In SNA, one of the types of 
network services in control points (CPs) and physical 
units (PUs). Management services are the services 
provided to assist in the management of SNA networks, 
such as problem management, performance and 
accounting management, configuration management 
and change management. See also configuration ser- 
vices, maintenance services, network services, and 
session services. 


mandatory cryptographic session. Synonym for 
required cryptographic session. 


mapped conversation. A type of conversation in which 
the data to be sent or received can be in a user-defined 
format. A logical unit (LU) that supports mapped con- 
versations converts the user data to a format suitable 
for the basic conversation protocol boundary. See also 
conversation and basic conversation. 


mapper. A NetView function that records errors from 


resources attached to a communication controller or 
from certain channel-attached devices. 
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master cryptography key. In SNA, a cryptographic key 
used to encipher operational keys that will be used at a 
node. 


maximum SSCP rerouting count. The maximum 
number of times a session initiation request will be 
rerouted to intermediate system services control points 
(SSCPs) before the request reaches the destination 
SSCP. This count is used to prevent endless rerouting 
of session initiation requests. 


MCH. Machine check handler. 
MDR. Miscellaneous data record. 


MERGE disk. The virtual disk in the VM operating 
system that contains program temporary fixes (PTFs) 
after the VMFMERGE EXEC is invoked. See BASE disk, 
DELTA disk, RUN disk, and ZAP disk. 


message. (1) (TC97) A group of characters and 
control bit sequences transferred as an entity. (2) In 
VTAM, the amount of function management data (FMD) 
transferred to VTAM by the application program with 
one SEND request. 


message unit. In SNA, the unit of data processed by 
any layer; for example, a basic information unit (BIU), a 
path information unit (PIU), or a request/response unit 
(RU). 


MIC. Middle-in-chain. 


middle-in-chain (MIC). A request unit (RU) whose 
request header (RH) begin chain indicator and RH end 
chain indicator are both off. See also RU chain. 


migration. Installing a new version or release of a 
program when an earlier version or release is already 
in place. 


minidisk. Synonym for virtual disk. 


minor node. In VTAM, a uniquely-defined resource 
within a major node. See node and major node. 


miscellaneous data record (MDR). A record ofa 
network hardware error recorded by the NCP and sent 
to the VTAM host that owns the failing component. 
Then VTAM writes the error on the operating system 
error data set. 


modem. A device that modulates and demodulates 
signals transmitted over data communication facilities. 
The term is a contraction for modulator-demodulator. 


mode name. A symbolic name for a set of session 
characteristics. For LU 6.2, a mode name anda 
partner LU name together define a group of parallel 
sessions having the same characteristics. 
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modulo level. The maximum number of path informa- 
tion units (PIUs) a device can send before stopping to 
wait for a response. 


MOSS. Maintenance and operator subsystem. 
MSHP. Maintain system history program. 
MSNF. Multisystem Networking Facility. 


multi-leaving. A variation of BSC communication that 
lets several devices communicate concurrently over a 
link without using station addresses. 


multiple-domain network. In SNA, a network with more 
than one system services control point (SSCP). Con- 
trast with single-domain network. 


multiple gateways. More than one gateway serving to 
connect the same two SNA networks for cross-network 
sessions. 


Multiple Virtual Storage (MVS). An IBM licensed 
program whose full name is the Operating 
System/Virtual Storage (OS/VS) with Multiple Virtual 
Storage/System Product for System/370. It is a soft- 
ware operating system controlling the execution of pro- 
grams. 


Multiple Virtual Storage for Extended Architecture 
(MVS/XA). An IBM licensed program whose full name 
is the Operating System/Virtual Storage (OS/VS) with 
Multiple Virtual Storage/System Product for Extended 
Architecture. Extended architecture allows 31-bit 
storage addressing. MVS/XA is a software operating 
system controlling the execution of programs. 


Multiple Virtual Storage/Operator Communication 
Control Facility (MVS/OCCF). A facility that intercepts 
messages from the MVS supervisor. NetView and 
MVS/OCCF help a network operator control multiple 
MVS systems from a central site. 


multipoint link. A link or circuit interconnecting several 
link stations. Synonymous with multidrop line. Con- 
trast with point-to-point link. 


Multisystem Networking Facility (MSNF). An optional! 
feature of TCAM and VTAM Version 1 that permits 
these access methods, together with NCP, to control a 
multiple-domain network. 


multi-tailed. When a communication controller with an 
NCP is attached to more than one host processor. See 
twin-tailed. See also fanout and tailing. 


multitasking. The ability of an operating system to run 
several programs concurrently. 


multi-thread application program. A VTAM application 
program that processes requests for more than one 


session concurrently. Contrast with single-thread 
application program. 


MVS. Multiple Virtual Storage operating system. 


MVS/OCCF. Multiple Virtual Storage/Operator Commu- 
nication Control Facility. 


MVS/XA. Multiple Virtual Storage for Extended Archi- 
tecture operating system. 


name translation. In SNA network interconnection, 
converting logical unit names, logon mode table 
names, and class-of-service names used in one 
network into equivalent names to be used in another 
network. This function can be provided through 
NetView and invoked by a gateway system services 
control point (SSCP) when necessary. See also alias 
name. 


native mode. In VTAM, a mode in which VTAM runs 
directly on the VM operating system rather than ona 
guest operating system. 


native network. The network in which a gateway NCP’s 
resources reside. 


NAV. Network addressable unit. 
NC. Network control. 
NCCF. Network Communications Control Facility. 


NCP. (1) Network Control Program (IBM licensed 
program). Its full name is Advanced Communications 
Function for the Network Control Program. Synony- 
mous with ACF/NCP. (2) Network control program 
(general term). 


NCP/EP definition facility (NDF). A program that is part 
of System Support Programs (SSP) and is used to gen- 
erate a partitioned emulation program (PEP) load 
module or a load module for a Network Control 
Program (NCP) or for an Emulation Program (EP). 


NCP major node. In VTAM, a set of minor nodes 
representing resources, such as lines and peripheral 
nodes, controlled by a network control program. See 
major node. 


NCP V4 Subset. Advanced Communications Function 
for Network Control Program (NCP) V4 Subset. An IBM 
licensed program that is a subset of NCP. It operates 
only on IBM 3720 Communication Controllers with 
certain capacity limitations such as number of scan- | 
ners, lines, and channel adapters supported. 


NCP/Token-Ring interconnection (NTRI). An NCP func- 
tion that allows a communication controller to attach to 
the IBM Token-Ring Network by providing a basic 
boundary network node interface. 


NDF. NCP/EP definition facility. 


negative polling limit. For an SS or BSC terminal, the 
maximum number of consecutive negative responses 
to polling that the communication controller accepts 
before suspending polling operations. 


negative response (NR). In SNA, a response indicating 
that a request did not arrive successfully or was not 
processed successfully by the receiver. Contrast with 
positive response. See exception response. 


negotiable BIND. In SNA, a capability that allows two 
LU-LU half-sessions to negotiate the parameters of a 
session when the session is being activated. 


negotiation. The process of deciding what packet size 
to transmit between a network and a 3710. 


NetView. A system 370-based IBM licensed program 
used to monitor a network, manage it, and diagnose its 
problems. 


NetView help desk. In the NetView program, an online 
information facility that guides the help desk operator 
through problem management procedures. 


NetView-NetView task (NNT). The task under which a 
cross-domain NetView operator session runs. See 
operator Station task. 


NetView/PC. A PC-based IBM licensed program 
through which application programs can be used to 
monitor, manage, and diagnose problems in IBM 
Token-Ring networks, non-SNA communication 
devices, and voice networks. 


NetView/PC application record. In the NetView/PC 
program, information that defines the communication 
path between the NetView/PC program and the host. 


network. (1) (TC97) An interconnected group of nodes. 
(2) In data processing, a user application network. See 
path control network, public network, SNA network, 
subarea network, type 2.1 network, and user- 
application network. 


network address. In SNA, an address, consisting of 
subarea and element fields, that identifies a link, a link 
station, or a network addressable unit. Subarea nodes 
use network addresses; peripheral nodes use local 
addresses. The boundary function in the subarea node 
to which a peripheral node is attached transforms local 
addresses to network addresses and vice versa. See 
local address. See also network name. 


network address translation. In SNA network intercon- 
nection, conversion of the network address assigned to 
a logical unit in one network into an address in an adja- 
cent network. This function is provided by the gateway 
NCP that joins the two networks. See also alias 
network address and rea/ network address. 
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network addressable unit (NAU). In SNA, a logical unit, 
a physical unit, or a system services control point. It is 
the origin or the destination of information transmitted 
by the path control network. Each NAU has a network 
address that represents it to the path control network. 
See also network name, network address, and path 
control network. 


Network Communications Control Facility (NCCF). An 
IBM licensed program that is a base for command 
processors that can monitor, control, automate, and 
improve the operations of a network. Its function is 
included and enhanced in NetView’s command facility. 


network configuration tables. The tables through which 
the system services control point (SSCP) interprets the 
network configuration. 


network control (NC). In SNA, an RU category used for 
requests and responses exchanged for such purposes 
as activating and deactivating-explicit and virtual 
routes and sending load modules to adjacent periph- 
eral nodes. See also data flow control layer and 
session control. 


network control mode. The functions of a network 
control program that enable it to direct a communi- 
cation controller to perform activities such as polling, 
device addressing, dialing, and answering. Contrast 
with emulation mode. 


Network Control Program (NCP). An IBM licensed | 
program that provides communication controller 
support for single-domain, multiple-domain, and inter- 
connected network capability. Its full name is 
Advanced Communications Function for the Network 
Control Program. 


network control program. A program, generated by the 
user from a library of IBM-supplied modules, that con- 
trols the operation of a communication controller. 


network control program generation. The process, per- 
formed in a host system, of validating, assembling, and 
link-editing network definition statements to produce a 
network control program. 


network controller. A concentrator and protocol con- 
verter used with SDLC links. By converting protocols, 
which manage the way data is sent and received, the 
IBM 3710 Network Controller allows the use of non-SNA 
devices with an SNA host processor. 


network identifier (network ID). The network name 
defined to NCPs and hosts to indicate the name of the 
network in which they reside. It is unique across all 
communicating SNA networks. communication among 
domains. 


network log. A file that contains all messages proc- 
essed by NetView. 
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Network Logical Data Manager (NLDM). An IBM 
licensed program that collects and correlates session- 
related data and provides online access to this informa- 
tion. It runs as an NCCF communication network 
management (CNM) application program. Its function 
is included and enhanced in NetView’s session 

monitor. 


network management vector transport (NMVT). A man- 
agement services request/response unit (RU) that flows 
over an active session between physical unit manage- 
ment services and control point management services 
(SSCP-PU session). 


network manager. A program or group of programs 
that is used to monitor, manage, and diagnose the 
problems of a network. 


network name. (1) In SNA, the symbolic identifier by 
which end users refer to a network addressable unit 
(NAU), a link, or a link station. See also network 
address. (2) In a multiple-domain network, the name 
of the APPL statement defining a VTAM application 
program is its network name and it must be unique 
across domains. Contrast with ACB name. See unin- 
terpreted name. 


network operator. (1) A person or program respon- 
sible for controlling the operation of all or part of a 
network. (2) The person or program that controls all 
the domains in a multiple-domain network. Contrast 
with domain operator. 


network operator console. A terminal in the network 
from which an operator controls the network. 


network performance analyzer (NPA). A function of 
NCP that collects performance data about devices. The 
data is recorded by NPM. 


NetView Performance Monitor (NPM). An IBM licensed 
program that collects, monitors, analyzes, and displays 
data relevant to the performance of a VTAM telecom- 
munication network. It runs as an online VTAM appli- 
cation program. 


Network Problem Determination Application (NPDA). 
An IBM licensed program that helps you identify 
network problems, such as hardware, software, and 
microcode, from a central control point using interac- 
tive display techniques. It runs as an NCCF communi- 
cation network management (CNM) application 
program. Its function is included and enhanced in 
NetView’s hardware monitor. 


network product support (NPS). The function of 
NetView that provides operations control for the IBM 
3710 Network Controller, 5860 family of modems, and 
the NCP; and configuration of 3710s and the 5860 family 
of modems. NPS provides operator commands to run 
diagnostics for link problem determination and to 
change product operating parameters. 


Network Routing Facility (NRF). An IBM licensed 
program that resides in the NCP, which provides a path 
for messages between terminals, and routes messages 
over this path without going through the host 
processor. 


network services (NS). In SNA, the services within 
network addressable units (NAUs) that contro! network 
operation through SSCP-SSCP, SSCP-PU, and SSCP-LU 
sessions. See configuration services, maintenance 
services, management services, and session services. 


network services (NS) header. In SNA, a 3-byte field in 
a function management data (FMD) request/response 
unit (RU) flowing in an SSCP-LU, SSCP-PU, or 
SSCP-SSCP session. The network services header is 
used primarily to identify the network services category 
of the request unit (RU) (for example, configuration ser- 
vices, session services) and the particular request 
code within a category. 


Network Terminal Option (NTO). An IBM licensed 
program used in conjunction with NCP that allows 
certain non-SNA devices to participate in sessions with 
SNA application programs in the host processor. NTO 
converts non-SNA protocol to SNA protocol when data 
is sent to the host from a non-SNA device and recon- 
verts SNA protocol to non-SNA protocol when data is 
sent back to the device. 


NIB. Node initialization block. 


NIB list. A series of contiguous node initialization 
blocks. 


NLDM. Network Logical Data Manager. 
NMVT. Network management vector transport. 
NNT. NetView-NetView task. 


node. (1) In SNA, an endpoint of a link or junction 
common to two or more links in a network. Nodes can 
be distributed to host processors, communication con- 
trollers, cluster controllers, or terminals. Nodes can 
vary in routing and other functional capabilities. See 
boundary node, host node, peripheral node, and 
subarea node (including illustration). (2) In VTAM, a 

- point in a network defined by a symbolic name. See 
major node and minor node. 


node initialization block (NIB). In VTAM, a control block 
associated with a particular node or session that con- 
tains information used by the application program to 
identify the node or session and to indicate how com- 
munication requests on a session are to be handled by 
VTAM. 


node name. In VTAM, the symbolic name assigned to a 
specific major or minor node during network definition. 


node type. In SNA, a designation of a node according 
to the protocols it supports and the network address- 
able units (NAUs) that it can contain. Five types are 
defined: 1, 2.0, 2.1, 4, and 5. Type 1, type 2.0, and type 
2.1 nodes are peripheral nodes; type 4 and type 5 ~ 
nodes are subarea nodes. See also type 2.1 node. 


non-generic alert. (1) In the NetView program, 
encoded alert information that uses product-unique 
screens stored at the alert receiver, the NetView 
program. (2) In the NetView/PC program, an alert con- 
taining X'9F' in the alert network management vector 
transport. 


non-native network. Any network attached to a 
gateway NCP that does not contain that NCP’s 
resources. 


Non-SNaA interconnection (NSI). An IBM licensed 
program that provides format identification (F1ID1/4) 
support for selected non-SNA facilities. Thus, it allows 
SNA and non-SNaA facilities to share SDLC links. It also 
allows the remote concentration of selected non-SNA. 
devices along with SNA devices. 


nonswitched data link. A connection between a link- 
attached device and a communication controller that 
does not have to be established by dialing. Contrast 
with switched data link. See also point-to-point data 
link and multipoint data link. 


nonswitched line. A telecommunication line on which 
connections do not have to be established by dialing. 
Contrast with switched line. 


no response. In SNA, a value in the form-of-response- 
requested field of the request header (RH) indicating 
that no response is to be returned to the request, 
whether or not the request is received and processed 
successfully. Contrast with definite response and 
exception response. 


normal flow. In SNA, a data flow designated in the 
transmission header (TH) that is used primarily to carry 
end-user data. The rate at which requests flow on the 
normal flow can be regulated by session-level pacing. 
Normal and expedited flows move in both the primary- 
to-secondary and secondary-to-primary directions. 
Contrast with expedited flow. 


notify. A network services request that is sent by an 
SSCP to a logical unit (LU) to inform the LU of the status 
of a procedure requested by the LU. 

NPA. Network performance analyzer. 

NPDA. Network Problem Determination Application. 


NPM. NetView Performance Monitor. 


NPS. Network product support. 
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NPSI. X.25 NCP Packet Switching Interface. 
NR. Negative response. 

NRF. Network Routing Facility. 

NS. Network services. 

NSI. Non-SNA Interconnection. 

NTO. Network Terminal! Option. 

NTRI. NCP/Token-Ring interconnection. 
OAF. Origin address field. 

OBR. Outboard record. 

OCCF. Operator Communication Control Facility. 
OIC. Only-in-chain. 

OLU. Origin logical unit. 


online. Stored in a computer and accessible from a ter- 
minal. 


only-in-chain (OIC). A request unit for which the 
request header (RH) begin chain indicator and RH end 
chain indicator are both on. See also RU chain. 


operand. (1) (ISO) An entity on which an operation is 
performed. (2) * That which is operated upon. An 
operand is usually identified by an address part of an 
instruction. (3) Information entered with a command 
name to define the data on which a command 
processor operates and to control the execution of the 
command processor. (4) An expression to whose 
value an operator is applied. See also definition state- 
ment, keyword, keyword parameter, and parameter. 


operator. (1) In a language statement, the lexical 
entity that indicates the action to be performed on oper- 
ands. (2) A person who operates a machine. See 
network operator. See also definition statement. 


Operator Communication Control Facility (OCCF). A 
licensed program that allows communication with and 
the operation of remote MVS or VSE systems. 


operator profile. In the NetView program, the 
resources and activities a network operator has control 
over. The statements defining these resources and 
activities are stored in a file that is activated when the 
operator logs on. 


operator station task (OST). The NetView task that 
establishes and maintains the online session with the 
network operator. There is one operator station task 
for each network operator who logs on to NetView. See 
NetView-NetView task. 
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option set. A set of functions that may be supported by 
products that implement a particular architecture. A 


_product may support any number of option sets or 


none. For each option set supported, all functions in 
that set are supported. See base set. 


orderly closedown. The orderly deactivation of VTAM 
and its domain. An orderly closedown does not com- 
plete until all application programs have closed their 
application control blocks (ACBs). Until then, 
RPL-based operations continue; however, no new ses- 
sions can be established and no new ACBs can be 
opened. Contrast with cancel closedown and quick 
closedown. 


origin address field (OAF). In SNA, a field in a FIDO or 
FID1 transmission header that contains the address of 
the originating network addressable unit (NAU). Con- 
trast with destination address field. See also format 
identification (FID) field and local session identification 
(LSID). 


origin logical unit (OLU). The logical unit from which 
data is sent. Contrast with destination logical unit 
(DLU). 


origin subarea field (OSAF). In SNA, a subarea field in 
a FID4 transmission header that contains a subarea 
address, which combined with the element address in 
the origin element field, gives the complete network 
address of the originating network addressable unit 
(NAU). Contrast with destination subarea field. 


OSAF. Origin subarea field (OSAF). 
OST. Operator station task. 


outboard record. A record originated by !/O and com- 
munication components and supported by the access 


_ methods. It describes permanent errors or reports sta- 


tistical data. 
PAB. Process anchor block. 


pacing. In SNA, a technique by which a receiving com- 
ponent controls the rate of transmission of a sending 
component to prevent overrun or congestion. See 
session-level pacing, send pacing, and virtual route 
(VR) pacing. See also flow control. 


pacing group. In SNA, (1) The path information units 
(PIUs) that can be transmitted on a virtual route before 
a virtual-route pacing response is received, indicating 
that the virtual route receiver is ready to receive more 
PiUs on the route. Synonymous with window. (2) The 
requests that can be transmitted on the normal flow in 
one direction on a session before a session-level 
pacing response is received, indicating that the 
receiver is ready to accept the next group of requests. 


pacing group size. In SNA, (1) The number of path 
information units (PIUs) in a virtual route pacing group. 


The pacing group size varies according to traffic con- 
gestion along the virtual route. Synonymous with 
window size. (2) The number of requests in a session- 
level pacing group. 


pacing response. In SNA, an indicator that signifies a 
receiving component's readiness to accept another 
pacing group; the indicator is carried in a response 
header (RH) for session-level pacing, and in a trans- 
mission header (TH) for virtual route pacing. 


packet switching. (TC97) The process of routing and 
transferring data by means of addressed packets so 
that a channel is occupied only during the transmission 
of a packet; upon completion of the transmission, the 
channel is made available for the transfer of other 
packets. 


page. (1) The portion of a panel that is shown ona 
display surface at one time. (2) To move back and 
forth among the pages of a multiple-page panel. See 
also scroll. (3) (ISO) In a virtual storage system, a 
fixed-length block that has a virtual address and that 
can be transferred between real storage and auxiliary 
storage. (4) To transfer instructions, data, or both 
between real storage and external page or auxiliary 
storage. 


panel. (1) A formatted display of information that 
appears on a terminal screen. See also help panel and 
task panel. Contrast with screen. (2) In computer 
graphics, a display image that defines the locations and 
characteristics of display fields on a display surface. 


parameter. (1) (ISO) A variable that is given a constant 
value for a specified application and that may denote 
the application. (2) An item in a menu for which the 
user specifies a value or for which the system provides 
a value when the menu is interpreted. (3) Data passed 
to a program or procedure by a user or another 
program, namely as an operand in a language state- 
ment, as an item in a menu, or as a shared data struc- 
ture. See also keyword, keyword parameter, and 
operand. 


parallel links. In SNA, two or more links between adja- 
cent subarea nodes. 


paraliel sessions. In SNA, two or more concurrently 
active sessions between the same two logical units 
(LUs) using different pairs of network addresses. Each 
session can have independent session parameters. 


partitioned emulation program (PEP) extension. A 
function of a network contro! program that enables a 
communication controller to operate some telecommu- 
nication lines in network control mode while simultane- 
ously operating others in emulation mode. 


partner-LU verification. For logical unit (LU) 6.2, a. 
three-flow exchange between two LUs with each LU 
using an LU-LU password and the Data Encryption 


Standard (DES) algorithm. The three-flow exchange is 
the LU-LU verification. See end-user verification. 


path. (1) In SNA, the series of path control network 
components (path control and data link control) that are 
traversed by the information exchanged between two 
network addressable units (NAUs). See also explicit 
route (ER), route extension, and virtual route (VR). 

(2) In VTAM when defining a switched major node, a 
potential dial-out port that can be used to reach that 
node. (3) In the NetView/PC program, a complete line 
in a configuration that contains all of the resources in 
the service point command service (SPCS) query link 
configuration request list. 


path block. In the NetView/PC program, a block of 
storage that contains the link connection component 
(LCC) information for all LCCs in one path. 


path control (PC). The function that routes message 
units between network addressable units (NAUs) in the 
network and provides the paths between them. It con- 
verts the BIUs from transmission control (possibly seg- 
menting them) into path information units (PiIUs) and 
exchanges basic transmission units (BTUs) and one or 
more P!Us with data link control. Path control differs 
for peripheral nodes, which use local addresses for 
routing, and subarea nodes, which use network 
addresses for routing. See peripheral path contro/ and 
subarea path control. See also /ink, peripheral node, 
and subarea node. 


path control (PC) layer. In SNA, the layer that manages 
the sharing of link resources of the SNA network and 
routes basic information units (BIUs) through it. See 
also BIU segment, blocking of PIUs, data link control 
layer, and transmission control layer. 


path control (PC) network. In SNA, the part of the SNA 
network that includes the data link control and path 
control layers. See SNA network and user application 
network. See also boundary function. 


path information unit (PIU). In SNA, a message unit 
consisting of a transmission header (TH) alone, or of a 
TH followed by a basic information unit (BIU) or a BIU 
segment. See also transmission header. 


path segment. In the NetView/PC program, the portion 
of a path between two resources that are listed consec- 
utively in the service point command service (SPCS) 


— query link configuration request list. 


path test. A test provided by NetView that enables a 
network operator to determine whether a path is avail- 
able between two LUs that are currently in session. 
PBX. Private branch exchange. 


PC. (1) Path control. (2) Personal Computer. Its full 
name is the IBM Personal Computer. 
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PCID. Procedure-correlation identifier. 


pending active session. In VTAM, the state of an LU-LU 
session recorded by the system services control point 
(SSCP) when it finds both logical units (LUs) available 
and has sent a CINIT request to the primary logical unit 
(PLU) of the requested session. 


PEP. Partitioned emulation program. 


performance class. In the NetView program, a 
description of an objective or commitment of perform- 
ance. It consists of a performance class name, 
boundary definitions, response time definition, 
response time ranges, and response time percentage 
objectives. Sessions may be assigned performance 
classes. 


performance error. Synonym for temporary error. 


peripheral host node. A node that provides an applica- 
tion program interface (API) for running application 
programs but does not provide SSCP functions and is 
not aware of the network configuration. The peripheral 
host node does not provide subarea node services. It 
has boundary function provided by its adjacent 
subarea. See boundary node, host node, node, periph- 
eral node, subarea host node, and subarea node. See 
also boundary function and node type. 


peripheral LU. In SNA, a logical unit representing a 
peripheral node. 


peripheral node. In SNA, a node that uses local 
addresses for routing and therefore is not affected by 
changes in network addresses. A peripheral node 
requires boundary-function assistance from an adja- 
cent subarea node. A peripheral node is a physical 
unit (PU) type 1, 2.0, or 2.1 node connected to a 
subarea node with boundary function within a subarea. 
See boundary node, host node, node, peripheral host 
node, subarea host node, and subarea node. See also 
boundary function and node type. 


peripheral path control. The function in a peripheral 
node that routes message units between units with 
local addresses and provides the paths between them. 
See path control and subarea path contro/. See also 
boundary function, peripheral node, and subarea node. 


peripheral PU. In SNA, a physical unit representing a 
peripheral node. 


permanent error. A resource error that cannot be 
resolved by error recovery programs. Contrast with 
temporary error. 


Personal Computer (PC). The IBM Personal Computer 


~ line of products including the 5150 and subsequent 
models. 
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physical connection. In VTAM, a point-to-point con- 
nection or multipoint connection. Synonymous with 
connection. 


physical unit (PU). In SNA, a type of network address- 
able unit (NAU). A physical unit (PU) manages and 
monitors the resources (such as attached links) of a 
node, as requested by a system services control point 
(SSCP) through an SSCP-PU session. An SSCP acti- 
vates a session with the physical unit in order to indi- 
rectly manage, through the PU, resources of the node 
such as attached links. See also peripheral PU and 
subarea PU. 


physical unit (PU) services. In SNA, the components 
within a physical unit (PU) that provide configuration 
services and maintenance services for SSCP-PU ses- 
sions. See also /ogical unit (LU) services. 


PIU. Path information unit. 

plaintext. Synonym for clear data. 

PLU. Primary logical unit.. 

PMX. Programmable operator message exchange. 
POI. Programmed operator interface. 


point-to-point link. A link that connects a single remote 
link station to a node; it may be either switched or non- 
switched. Contrast with multipoint link. 


polling. (1) * Interrogation of devices for purposes 
such as to avoid contention, to determine operational 
status, or to determine readiness to send or receive 
data. (2) (TC97) The process whereby stations are 
invited, one at a time, to transmit. 


positional operand. An operand in a language state- 
ment that has a fixed position. See also definition 
statement. Contrast with keyword operand. 


positive response. A response indicating that a request 
was received and processed. Contrast with negative 
response. 


PPO. Primary program operator application program. 
PPT. Primary POI task. 


presentation services command processor (PSCP). In 
NetView, a facility that processes requests from a user 
terminal and formats displays to be presented at the 
user terminal. 


primary application program. In VITAM, an application 
program acting as the primary end of an LU-LU 
session. 


primary data base. The main data base provided to the 
NetView user for recording error data. See secondary 
data base. 


primary end of a session. The end of a session that 
uses primary protocols. The primary end establishes 
the session. For an LU-LU session, the primary end of 
the session is the primary logical unit. Contrast with 
secondary end of a session. See half-session. 


primary half-session. In SNA, the half-session that 
sends the session activation request. See also primary 
logical unit. Contrast with secondary half-session. 


primary logical unit (PLU). In SNA, the logical unit (LU) 
that contains the primary half-session for a particular 
LU-LU session. Each session must have a PLU and 
secondary logical unit (SLU). The PLU is the unit 
responsible for the bind and is the controlling LU for 
the session. A particular LU may contain both primary 
and secondary half-sessions for different active LU-LU 
sessions. Contrast with secondary logical unit (SLU). 


primary path. (1) The channel an operation first uses. 
(2) In CCP, one of two paths defined for information 
flow to and from the physical units attached to the 
network by means of an IBM 3710 Network Controller. 
The primary path is the path that is normally used. See 
alternate path. 


primary POI task (PPT). The NetView subtask that proc- 
esses all unsolicited messages received from the 
VTAM program operator interface (POI) and delivers 
them to the controlling operator or to the command 
processor. The PPT also processes the initial 
command specified to execute when NetView is initial- 
ized and timer request commands scheduled to 
execute under the PPT. 


primary program operator application program (PPO). 
A program operator application program that is author- 
ized to receive unsolicited messages. When the PPO is 
active, all unsolicited messages will go to the PPO. 
Conversely, when the PPO is inactive, unsolicited mes- 
sages will go to the system console. There can be only 
one PPO in any domain. 


primary session. An extended recovery facility (XRF) 
session between the active application subsystem and 
a terminal user. 


private branch exchange. A switching system that pro- 
vides internal telephone communication between 
private branch stations and external networks. 


problem determination. The process of identifying the 
source of a problem; for example, a program compo- 
nent, a machine failure, telecommunication facilities, 
user or contractor-installed programs or equipment, an 
environment failure such as a power loss, or a user 
error. 


process anchor block (PAB). In VTAM, a process 
scheduling services dispatch point. 


procedure-correlation identifier (PCID). In SNA, a value 
used by a control point to correlate requests and 
replies. 


product-set identification (PSID). (1) In SNA, a tech- 
nique for identifying the hardware and software pro- 
ducts that implement a network component. (2) A 
management services common subvector that trans- 
ports the information described in definition (1). 


profile. In the Conversational Monitor System (CMS) or 
the group control system (GCS), the characteristics 
defined by a PROFILE EXEC file that executes automat- 
ically after the system is loaded into a virtual machine. 
See also operator profile. 


programmed operator. A VTAM application program 
that is authorized to issue VTAM operator commands 
and receive VTAM operator awareness messages. See 
also solicited messages and unsolicited messages. 


programmed operator interface (POI). A VTAM function 
that allows programs to perform VTAM operator func- 
tions. 


programmable operator facility (PROP). A VM facility 
that allows remote control of a virtual machine by inter- 
cepting messages directed for that machine and taking 
preprogrammed action. 


programmable operator message exchange (PMX). 

The interface that gives the NetView operator the ability 
to communicate with the programmable operator 
facility. 


program temporary fix (PTF). A temporary solution or 
bypass of a problem diagnosed by IBM in a current 
unaltered release of the program. 


PROP. Programmable operator facility. 


protection key. An indicator that appears in the current 
program status word whenever an associated task has 
control of the system. This indicator must match the 
storage keys of all main storage locks that the task is to 
use. 


protocol. (1) (CCITT/ITU) A specification for the format 
and relative timing of information exchanged between 
communicating parties. (2) (TC97) The set of rules 
governing the operation of functional units of a commu- 
nication system that must be followed if communication 
is to be achieved. (3) In SNA, the meanings of, and the 
sequencing rules for, requests and responses used for 
managing the network, transferring data, and synchro- 
nizing the states of network components. See also 
bracket protocol. Synonymous with line control disci- 
pline and line discipline. See also link protocol. 
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protocol boundary. (1) A synonym for the architec- 
turally defined logical unit (LU) 6.2 application program 
interface (API). (2) Any internal interface between 
components in a node. 


PSCP. Presentation services command processor. 
PSID. Product-set identification. 

PTF. Program temporary fix. 

PU. Physical unit. 

PU type. Physical unit type. 


public network. A network established and operated by 
communication common carriers or telecommunication 
Administrations for the specific purpose of providing 
circuit-switched, packet-switched, and leased-circuit 
services to the public. Contrast with user-application 
network. 


PU-PU flow. In SNA, the exchange between physical 
units (PUs) of network control requests and responses. 


queued BIND. In VTAM, a BIND sent from the primary 
logical unit (PLU) to the secondary logical unit (SLU) 
that has not yet been responded to by the SLU. 


queued CINIT. In VTAM, a CINIT sent from a system 
services control point (SSCP) to a logical unit (LU) that 
has not yet been responded to by the LU. 


queued session. In VTAM, pertaining to a requested 
LU-LU session that cannot be started because one of 
the logical units (LUs) is not available. If the session- 
initiation request specified queuing, the system ser- 
vices control points (SSCPs) will record the request and 
later continue with the session-establishment proce- 
dure when both LUs become available. 


quick closedown. In VTAM, a closedown in which any 
RPL-based communication macroinstruction is termi- 
nated (posted complete with an error code) and no new 
sessions can be established and no new ACBs can be 
opened. See also cancel closedown and orderly close- 
down. 


quiesce. (1) * To bring a system or a device to a halt 
by rejecting new requests for work. (2) Ina VTAM 
application program, for one node to stop another node 
from sending synchronous-flow messages. 


quiesce protocol. In VTAM, a method of communi- 
cating in one direction at atime. Either the primary 
logical unit (PLU) or the secondary logical unit (SLU) 
assumes the exclusive right to send normal-flow 
requests, and the other node refrains from sending 
such requests. When the sender wants to receive, it 
releases the other node from its quiesced state. 
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RACF. Resource Access Control Facility. 
RDT. Resource definition table. 


real name. The name by which a logical unit (LU), 


' logon mode table, or class-of-service (COS) table is 


known within the SNA network in which it resides. 


real network address. The address by which a logical 
unit (LU) is known within the SNA network in which it 
resides. 


receive pacing. In SNA, the pacing of message units 
that the component is receiving. See also send pacing. 


RECFMS. Record formatted maintenance statistics. 
RECMS. Record maintenance statistics. 


Recommendation X.21 (Geneva 1980). A Consultative 
Committee on International Telegraph and Telephone 
(CCITT) recommendation for a general purpose inter- 
face between data terminal equipment and data circuit 
equipment for synchronous operations on a public data 
network. 


Recommendation X.25 (Geneva 1980). A Consultative 
Committee on International Telegraph and Telephone 
(CCITT) recommendation for the interface between data 
terminal equipment and packet-switched data net- 
works. See also packet switching. 


recommended action. Procedures suggested by 
NetView that can be used to determine the causes of 
network problems. 


record formatted maintenance statistics (RECFMS). A 
statistical record built by an SNA controller and usually 
solicited by the host. 


recording filter.. In the NetView program, the function 
that determines which events, statistics, and alerts are 
stored on a data base. 


record maintenance statistics (RECMS). An SNA error 
event record built from an NCP or line error and sent 
unsolicited to the host. 


reentrant. The attribute of a program or routine that 
allows the same copy of the program or routine to be 
used concurrently by two or more tasks. For example, 
the 3710 Network Controller routines may be reentrant. 


regular command. In the NetView program, any VIAM 
or NetView command that is not an immediate 
command and is processed by a regular command 
processor. Contrast with immediate command. 


release. For VTAM, to relinquish control of resources 
(communication controllers or physical units). See also 
resource takeover. Contrast with acquire (2). 


remote. Concerning the peripheral parts of a network 
not centrally linked to the host processor and generally 
using telecommunication lines with public right-of-way. 


remote console function. In the NetView/PC program, 
the function that allows one PC to control another. 


remote modem self-test (RST). A check on hardware to 
identify a field-replaceable unit that is failing. 


remote PC. In the NetView/PC program, the PC that 
runs the local PC, which has had its keyboard locked by 
means of the remote control function. Contrast with 
local PC. 


remote spooling communications subsystem (RSCS). A 
VM networking component that provides telecommuni- 
cation facilities for the transmission of bulk files 
between VM users and remote stations. 


replacement code point. In alerts, a 2-byte code point 
in which the first byte indexes text providing a high- 
level description of a condition and the second byte 
indexes text providing a more specific description. The 
second byte is nonzero. See default code point. 


REQMS. Request for maintenance statistics. 


request for maintenance statistics (REQMS). A host 
solicitation to an SNA controller for a statistical data 
record. 


request header (RH). In SNA, control information pre- 
ceding a request unit (RU). See also request/response 
header (RH). 


request parameter list (RPL). In VTAM, a control block 
that contains the parameters necessary for processing 
a request for data transfer, for establishing or termi- 
nating a session, or for some other operation. 


request unit (RU). In SNA, a message unit that contains 
control information, end-user data, or both. 


request/response header (RH). In SNA, control infor- 
mation, preceding a request/response unit (RU), that 
specifies the type of RU (request unit or response unit) 
and contains control information associated with that 
RU. 


request/response unit (RU). In SNA, a generic term for 
a request unit or a response unit. See also request unit 
(RU) and response unit. 


required cryptographic session. A cryptographic 
session in which all outbound data is enciphered and 
all inbound data is deciphered. Synonymous with man- 
datory cryptographic session. Contrast with selective 
cryptographic session and clear session. 


resource. (1) Any facility of the computing system or 
operating system required by a job or task, and 


including main storage, input/output devices, the proc- 
essing unit, data sets, and control or processing pro- 
grams. (2) In the NetView program, any hardware or 
software that provides function to the network. 


Resource Access Control Facility (RACF). A licensed 
program that provides for access control by identifying 
and verifying users to the system, authorizing access to 
DASD data sets, logging detected unauthorized 
attempts to enter the system, and logging detected 
accesses to protected data sets. 


resource definition table (RDT). In VTAM, a table that 
describes the characteristics of each node available to 
VTAM and associates each node with a network 
address. This is the main VTAM network configuration 
table. 


resource hierarchy. In VTAM, the relationship among 
network resources in which some resources are subor- 
dinate to others as a result of their position in the 
network structure and architecture; for example, the 
logical units (LUs) of a peripheral physical unit (PU) are 
subordinate to that PU, which, in turn, is subordinate to 
the link attaching it to its subarea node. 


resource level. In the NetView program, the hierar- 
chical position of a device (and the software contained 
within it) in a data processing system. For example, a 
first-level resource would be the communication con- 
troller, and the second-level resource would be the line 
connected to it. 


resource takeover. In VTAM, action initiated by a 
network operator to transfer control of resources from 
one domain to another. See also acquire (2) and 
release. See takeover. 


resource types. In the NetView program, a concept to 
describe the organization of panels. Resource types 
are defined as central processing unit, channel, control 
unit, and I/O device for one category; and communi- 
cation controller, adapter, link, cluster controller, and 
terminal for another category. Resource types are 
combined with data types and display types to describe 
display organization. See also data types and display 
types. 


responded output. In VTAM, a type of output request 
that is completed when a response is returned. Con- 
trast with scheduled output. 


response header (RH). In SNA, a header, optionally fol- 
lowed by a response unit (RU), that indicates whether 
the response is positive or negative and that may 
contain a pacing response. See also negative 
response, pacing response, and positive response. 


response time. (1) The amount of time it takes after a 
user presses the enter key at the terminal until the 
reply appears at the terminal. (2) For response time 
monitoring, the time from the activation of a transaction 
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until a response is received, according to the response 
time definition coded in the performance class. 


response time monitor (RTM). A feature available with 
certain hardware devices to allow measurement of 
response times, which may be collected and displayed 
by NetView. 


response unit (RU). In SNA, a message unit that 
acknowledges a request unit; it may contain prefix 
information received in a request unit. If positive, the 
response unit may contain additional information (such 
as session parameters in response to Bind Session), or 
if negative, contains sense data defining the exception 
condition. 


return code. * A code [returned from a program] used 
to influence the execution of succeeding instructions. 


REX. Route extension. 

RH. Request/response header. 

ring. A network configuration where a series of 
attaching devices are connected by unidirectional 
transmission links to form a closed path. 

route. See explicit route and virtual route. 

route extension (REX). In SNA, the path control 
network components, including a peripheral link, that 
make up the portion of a path between a subarea node 
and a network addressable unit (NAU) in an adjacent 
peripheral node. See also path, explicit route (ER), and 
virtual route (VR). 

Route Table Generator (RTG). An !BM-supplied field 
developed program that assists the user in generating 
path tables for SNA networks. 

RPL. Request parameter list. 

RPL exit routine. In VTAM, an application program exit 
routine whose address has been placed in the EXIT 
field of a request parameter list (RPL). VTAM invokes 
the routine to indicate that an asynchronous request 
has been completed. See EXLST exit routine. 
RPL-based macroinstruction. In VTAM, a macroin- 
struction whose parameters are specified by the user 
in a request parameter list. 

RSCS. Remote spooling communications subsystem. 
RST. Remote modem self-test. 

RTG. Route Table Generator. 


RTM. Response time monitor. 


RU. Request/response unit. 
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RU chain. In SNA, a set of related request/response 
units (RUs) that are consecutively transmitted on a par- 
ticular normal or expedited data flow. The request RU 
chain is the unit of recovery: if one of the RUs in the 
chain cannot be processed, the entire chain is dis- 
carded. Each RU belongs to only one chain, which has 
a beginning and an end indicated by means of control 
bits in request/response headers within the RU chain. 
Each RU can be designated as first-in-chain (FIC), last- 
in-chain (LIC), middle-in-chain (MIC), or only-in-chain 
(OIC). Response units and expedited-flow request units 
are always sent as only-in-chain. 


RUN disk. The virtual disk that contains the VTAM and 
VM SNA console support (VSCS) load libraries, 
program temporary fixes (PTFs) and user-written mod- 
ifications from the ZAP disk. See BASE disk, DELTA 
disk, MERGE disk, and ZAP disk. 


same-domain LU-LU session. In SNA, an LU-LU 
session between logical units (LUs) in the same 
domain. Contrast with cross-domain LU-LU session. 


SAW data. Synonym for session awareness (SAW) 
data. 


SC. Session control. 


scanner. (1) A device capable of electronically 
reviewing amounts of data and translating the data into 
a machine readable form. (2) For the 3725 communi- 
cation controller, a processor dedicated to controlling a 
small number of telecommunication lines. It provides 
the connection between the line interface coupler hard- 
ware and the central control unit. 


scanner interface trace (SIT). A record of the activity 
within the communication scanner processor (CSP) for 
a specified data link between a 3725 Communication 
Controller and a resource. 


scheduled output. In VTAM, a type of output request 
that is completed, as far as the application program is 
concerned, when the program’s output data area is 
free. Contrast with responded output. 


SCIF. Single console image facility. 
SCIP exit. Session control in-bound processing exit. 


scope of commands. In the NetView program, the 
facility that provides the ability to assign different 
responsibilities to various operators. 


screen. An illuminated display surface; for example, 
the display surface of a CRT or plasma panel. Contrast 
with panel. 


scroll. To move all or part of the display image verti- 
cally to display data that cannot be observed within a 
single display image. See also page (2). 


SCS. SNA character string. 

SDLC. Synchronous Data Link Control. 
secondary application program. An application 
program acting as the secondary end of an LU-LU 


session. 


secondary data base. One of two data bases provided 
by NetView for recording data. It provides backup or a 


temporary storage alternative to the primary data base. 


See primary data base. 


secondary end of a session. That end of a session that 
uses secondary protocols. For an LU-LU session, the 
secondary end of the session is the secondary logical 
unit (SLU). Contrast with primary end of a session. 
See also secondary logical unit (SLU) and half-session. 


secondary half-session. In SNA, the half-session that 
receives the session-activation request. See also sec- 
ondary logical unit (SLU). Contrast with primary half- 
session. 


secondary logical unit (SLU). In SNA, the logical unit 
(LU) that contains the secondary half-session for a par- 
ticular LU-LU session. An LU may contain secondary 
and primary half-sessions for different active LU-LU 
sessions. Contrast with primary logical unit (PLU). 


secondary logical unit (SLU) key. A key-encrypting key 
used to protect a session cryptography key during its 
transmission to the secondary half-session. 


secondary program operator application program 
(SPO). A program operator application program that is 
not authorized to receive unsolicited messages. An 
SPO can receive only the messages generated by com- 
mands it issued. There can be more than one SPO ina 
domain in addition to a primary program operator 
application program (PPO). Contrast with primary 
program operator application program. 


segment. See /ink connection segment. 


segment file. A file that contains all the path segments 
in a particular configuration segment. 


segmenting of BIUs. In SNA, an optional function of 
path control that divides a basic information unit (BIU) 
received from transmission control into two or more 
path information units (PIUs). The first PIU contains the 
request header (RH) of the BIU and usually part of the 
RU; the remaining PIU or PiUs contain the remaining 
parts of the RU. When segmenting is not done, a PIU 
contains a complete BIU. 


selective cryptographic session. A cryptographic 
session in which an application program is allowed to 
specify the request units to be enciphered. Contrast 
with required cryptographic session and clear session. 


send pacing. In SNA, pacing of message units that a 
component is sending. See also receive pacing. 


serial networks. A group of SNA networks connected in 
series by gateways. 


Service Level Reporter (SLR). A licensed program that 
generates management reports from data sets such as 
System Management Facility (SMF) files. 


service point (SP). An entry point that supports appli- 
cations that provide network management for 
resources not under the direct control of itself as an 
entry point. Each resource is either under the direct 
control of another entry point or not under the direct 
control of any entry point. A service point accessing 
these resources is not required to use SNA sessions 
(unlike a focal point). A service point is needed when 
entry point support is not yet available for some 
network management function. 


service point command facility (SPCF). A program or 
function that exchanges data and control between the 
network operator, the link connection component 
manager (LCCM), and the link connection subsystem 
manager (LCSM). 


service point command service (SPCS). An extension 
of the command facility in the NetView program that 
allows the host processor to communicate with a 
service point by using the communication network 
management (CNM) interface. 


service reminder (SR). In the NetView/PC program, a 
notification set by the operator that is displayed ona 
panel and logs a specified message. 


session. In SNA, a logical connection between two 
network addressable units (NAUs) that can be acti- 
vated, tailored to provide various protocols, and deacti- 
vated, as requested. Each session is uniquely 
identified in a transmission header (TH) by a pair of 
network addresses, identifying the origin and destina- 
tion NAUs of any transmissions exchanged during the 
session. See half-session, LU-LU session, SSCP-LU 
session, SSCP-PU session, and SSCP-SSCP session. 
See also LU-LU session type and PU-PU flow. 


session activation request. In SNA, a request that acti- 
vates a session between two network addressable units 
(NAUs) and specifies session parameters that control 
various protocols during session activity; for example, 
BIND and ACTPU. Contrast with session deactivation 
request. 


session address space. In VTAM, an ACB address 
space or an associated address space in which an 
OPNDST or OPNSEC macroinstruction is issued to 
establish a session. See also ACB address space and 
associated address space. 
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session awareness (SAW) data. Data collected by 
NetView about a session that includes the session type, 
the names of session partners, and information about 
the session activation status. It is collected for LU-LU, 
SSCP-LU, SSCP-PU, and SSCP-SSCP sessions and for 
non-SNA terminals not supported by NTO. It can be 
displayed in various forms, such as most recent ses- 
sions lists. 


session control (SC). In SNA, (1) One of the compo- 
nents of transmission control. Session control is used 
to purge data flowing in a session after an unrecover- 
able error occurs, to resynchronize the data flow after 
such an error, and to perform cryptographic verifica- 
tion. (2) A request unit (RU) category used for requests 
and responses exchanged between the session control 
components of a session and for session activation and 
deactivation requests and responses. 


session control in-bound processing exit (SCIP). A 
user exit that receives contro! when certain request 
units (RUs) are received by VTAM. 


session cryptography key. In SNA, a data encrypting 
key used to encipher and decipher function manage- 
ment data (FMD) requests transmitted in an LU-LU 
session that uses Cryptography. 


session data. Data about a session, collected by 
NetView, that consists of session awareness data and 
session trace data. 


session deactivation request. In SNA, a request that 
deactivates a session between two network address- 
able units (NAUs); for example, UNBIND and DACTPU 
Synonymous with generic unbind. Contrast with 
session activation request. 


session-establishment macroinstructions. In VTAM, the 
set of RPL-based macroinstructions used to initiate, 
establish, or terminate LU-LU sessions. 


session-establishment request. In VTAM, a request to 
an LU to establish a session. For the primary logical 
unit (PLU) of the requested session, the session- 
establishment request is the CINIT sent from the 
system services control point (SSCP) to the PLU. For 
the secondary logical unit (SLU) of the requested 
session, the session-establishment request is the BIND 
sent from the PLU to the SLU. 


session information block (SIB). A.control block that 
contains information about a particular SNA session. 


session information retrieval (SIR). The function that 
allows an operator to enable or disable session infor- 
mation retrieval for a particular gateway or for all 
gateway sessions. When a gateway session ends, 
trace information about the most recent sequence or 
FIDO numbers to cross the gateway is passed back to 
all system services control points (SSCPs) that have 
enabled SIR for that session or for all sessions. This 


X-40 NetView Operation 


information can also be passed back to the requesting 
host. 


session-initiation request. In SNA, an Initiate or logon 
request from a logical unit (LU) to a control point (CP) 
that an LU-LU session be activated. 


session-level pacing. In SNA, a flow control technique 
that permits a receiver to control the data transfer rate 
(the rate at which it receives request units) on the 
normal flow. It is used to prevent overloading a 
receiver with unprocessed requests when the sender 
can generate requests faster than the receiver can 
process them. See also pacing and virtua! route 
pacing. 


session-level security. For logical unit (LU) 6.2, partner 
LU verification and session cryptography. See 
conversation-level security. 


session limit. (1) In SNA, (a) the maximum number of 
concurrently active LU-LU sessions a particular logical 
unit can support; (b) the limit that determines how 
many sessions may be active between two logical units 
(LUs) that are using LU 6.2 protocols and a given mode 
name. Each partner LU is allocated a minimum share 
of contention-winner sessions within this limit. (2) In 
the network control program, the maximum number of 
concurrent line-scheduling sessions on a non-SDLC, 
multipoint line. 


session management exit routine. An installation- 
supplied VTAM exit routine that performs authorization, 
accounting, and gateway path selection functions. 


session monitor. The component of NetView that col- 
lects and correlates session-related data and provides 
online access to this information. 


session parameters. In SNA, the parameters that 
specify or constrain the protocols (such as bracket pro- 
tocol and pacing) for a session between two network 
addressable units. See also logon mode. 


session partner. In SNA, one of the two network 
addressable units (NAUs) having an active session. 


session seed. Synonym for initial chaining value. 


session sequence number. In SNA, a sequentially- 
incremented identifier that is assigned by data flow 
control to each request unit on a particular normal flow 
of a session, typically an LU-LU session, and is 
checked by transmission control. The identifier is 
carried in the transmission header (TH) of the path 
information unit (PIU) and is returned in the TH of any 
associated response. Contrast with virtual route 
sequence number. 


session services. In SNA, one of the types of network 
services in the control point (CP) and in the logical unit 
(LU). These services provide facilities for an LU ora 


network operator to request that the SSCP initiate or 
terminate sessions between logical units. See config- 
uration services, maintenance services, and manage- 
ment services. 


session setup failure notification (SSFN). Session 
awareness data provided by NetView when there is a 
failure. It identifies the system services control point 
(SSCP) that detects an error, which SSCPs are 
involved, and the names of the session partners 
affected. 


session-termination request. In VTAM, a request that 
an LU-LU session be terminated. 


session trace. In the NetView program, the function 
that collects session trace data for sessions involving 
specified resource types or involving a specific 
resource. 


session trace data. Data relating to sessions that is 
collected by NetView whenever a session trace is 
started and that consists of session activation parame- 
ters, VTAM path information unit (PIU) data, and NCP 
data. 


shadow resource. In VTAM, an alternate represen- 
tation of a network resource that is retained as a defi- 
nition for possible future use. 


share limit. In SNA, the maximum number of control 
points that can concurrently contro! a network 
resource. 


shared. Pertaining to the availability of a resource to 
more than one use at the same time. 


shared-control gateway. A gateway consisting of one 
gateway NCP that is controlied by more than one 
gateway system services control point (SSCP). 


shared session. A feature of a saved system that can 
be shared by one or more segments of reentrant code 
in real storage in a virtual machine group. 


show cause. The reason code in the RECMS indicating 
to VITAM or NetView the threshold that was exceeded 
and whether or not the threshold has been dynamically 
altered. 


shutdown. To stop or quiesce a NetView/PC or a 
NetView/PC application program. 


SIB. Session information block. 


sift-down effect. The copying of a value from a higher- 
level resource to a lower-level resource. The sift-down 
effect applies to many of the keywords and operands in 
NCP and VTAM definition statements. If an operand is 
coded on a macroinstruction or generation statement 
for a higher-level resource, it need not be coded for 
lower-level resources for which the same value is 


desired. The value “sifts down,” that is, becomes the 
default for all lower-level resources. 


simple gateway. A gateway consisting of one gateway 
NCP and one gateway system services control point 
(SSCP). 


simulated logon. A session-initiation request gener- 
ated when a VTAM application program issues a 
SIMLOGON macroinstruction. The request specifies a 
logical unit (LU) with which the application program 
wants a session in which the requesting application 
program will act as the primary logical unit (PLU). 


single console image facility (SCIF). A VM facility that 
allows multiple consoles to be controlled froma 
single, virtual machine console. 

single-domain network. In SNA, a network with one 
system services contro! point (SSCP). Contrast with 
multiple-domain network. 

single-thread application program. A VTAM application 
program that processes requests for multiple sessions 
one atatime. Such a program usually requests syn- 
chronous operations from VTAM, waiting until each 
operation is completed before proceeding. Contrast 
with multithread application program. 

SIR. Session information retrieval. 

SIT. Scanner interface trace. 

SLR. Service Level Reporter. 

SLU. Secondary logical unit. 

SMF. System management facility. 

SMP. System Modification Program. 

SMP/E. System Modification Program Extended. 

SNA. Systems Network Architecture. 


SNA character string (SCS). A character string com- 
posed of EBCDIC controls, optionally intermixed with 


end-user data, that is carried within a request/response 


unit. 


SNA network. The part of a user-application network 
that conforms to the formats and protocols of Systems 
Network Architecture. It enables reliable transfer of 
data among end users and provides protocols for con- 
trolling the resources of various network configura- 
tions. The SNA network consists of network 
addressable units (NAUs), boundary function compo- 
nents, and the path control network. 


SNA network interconnection. The connection, by gate- 


ways, of two or more independent SNA networks to 
allow communication between logical units in those 
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networks. The individual SNA networks retain their 
independence. 


_ SNA terminal. A terminal that supports Systems 
Network Architecture protocols. 


SNASVCMG mode name. SNA service manager mode 
name. This is the architecturally defined mode name 
identifying sessions on which CNOS is exchanged. 


SNBU. Switched network backup. 


solicited message. A response from VTAM toa 
command entered by a program operator. Contrast 
with unsolicited message. 


SP. Service point. 
SPCF. Service point command facility. 
SPCS. Service point command service. 


span. In the NetView program, a user-defined group of 
network resources within a single domain. Each major 
or minor node is defined as belonging to one or more 
spans. See also span of control. 


span of control. The total network resources over 
which a particular network operator has control. All 
the network resources listed in spans associated 
through profile definition with a particular network 
operator are within that operator’s span of control. 


specific-mode. In VTAM: (1) The form of a RECEIVE 
request that obtains input from one specific session. 
(2) The form of an accept request that completes the 
establishment of a session by accepting a specific 
queued CINIT request. Contrast with any-mode. See 
continue-specific mode. 


SPO. Secondary program operator application 
program. 


SR. Service reminder. 
SS. Start-stop. 
SSCP. System services contro! point. 


SSCP ID. In SNA, a number that uniquely identifies a 
system services control point (SSCP). The SSCP ID is 
used in session activation requests sent to physical 
units (PUs) and other SSCPs. 


SSCP. rerouting. In SNA network interconnection, the 
technique used by the gateway system services control 
point (SSCP) to send session-initiation request units 
(RUs), by way of a series of SSCP-SSCP sessions, from 


one SSCP to another, until the owning SSCP is reached. 


SSCP-LU session. In SNA, a session between a system 
services control point (SSCP) and a logical unit (LU); 
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the session enables the LU to request the SSCP to help 
initiate LU-LU sessions. 


SSCP-PU session. In SNA, a session between a system 
services control point (SSCP) and a physical unit (PU); 
SSCP-PU sessions allow SSCPs to send requests to 
and receive status information from individual nodes in 
order to control the network configuration. 


SSCP-SSCP session. In SNA, a session between the 
system services contro! point (SSCP) in one domain 
and the SSCP in another domain. An SSCP-SSCP 
session is used to initiate and terminate cross-domain 
LU-LU sessions. 


SSFN. Session setup failure notification. 


SSP. System Support Programs (IBM licensed 
program). Its full name is Advanced Communications 
Function for System Support Programs. Synonymous 
with ACF/SSP. 


ST. Session configuration screen abbreviation. 


start option. In VTAM, a user-specified or IBM-supplied 
option that determines certain conditions that are to 
exist during the time a VTAM system is operating. 

Start options can be predefined or specified when 
VTAM is started. 


start-stop transmission. (1) (TC97) Asynchronous 
transmission such that a group of signals representing 
a character is preceded by a start element and is fol!- 
lowed by a stop element. (2) Asynchronous trans- 
mission in which a group of bits is preceded by a start 
bit that prepares the receiving mechanism for the 
reception and registration of a character and is fol- 
lowed by at least one stop bit that enables the receiving 
mechanism to come to an idle condition pending the 
reception of the next character. See also binary syn- 
chronous transmission and synchronous data link 
control. 


statement. A language syntactic unit consisting of an 
operator, or other statement identifier, followed by one 
or more operands. See definition statement. 


statement identifier. The lexical entity in a language 


statement that indicates the purpose of the statement, 
such as the action to be performed or the resource 
being defined. See also definition statement, definition 
statement identifier, and operator. 


station. (1) One of the input or output points of a 
network that uses communication facilities; for 
example, the telephone set in the telephone system or 
the point where the business machine interfaces with 
the channel on a leased private line. (2) One or more 
computers, terminals, or devices at a particular 
location. 


statistic. In the NetView program, a resource- 
generated data base record that contains recoverable 
error counts, traffic, and other significant data about a 
resource. 


status code. In VTAM, information on the status of a 
resource as shown in a 10-character state code; for 
example, STATEACTIV for active. 


status modifier. (1) In a System/370 status code, an 
indicator of the input/output (I/O) status. (2) In VTAM, 
a specific character appearing in specific positions of 
the status code; for example, B in the 10th position indi- 
cates a backup. 


status monitor. A component of NetView that collects 
and summarizes information on the status of resources 
defined in a VITAM domain. 


subarea. A portion of the SNA network consisting of a 
subarea node, any attached peripheral nodes, and their 
associated resources. Within a subarea node, all 
network addressable units, links, and adjacent link 
stations (in attached peripheral or subarea nodes) that 
are addressable within the subarea share a common 
subarea address and have distinct element addresses. 


subarea address. In SNA, a value in the subarea field 
of the network address that identifies a particular 
subarea. See also element address. 


subarea/element address split. The division of a 16-bit 
network address into a subarea address and an 
element address. 


subarea host node. A host node that provides both 
subarea function and an application program interface 
(AP!) for running application programs. It provides 
system services control point (SSCP) functions, 
subarea node services, and is aware of the network 
configuration. See boundary node, communication 
management configuration host node, data host node, 
host node, node, peripheral node, and subarea node. 
See also boundary function and node type. 


subarea link. In SNA, a link that connects two subarea 
nodes. See channel link and link. 


subarea LU. In SNA, a logical unit in a subarea node. 
Contrast with peripheral LU. 


subarea node. In SNA, a node that uses network 
addresses for routing and whose routing tables are 
therefore affected by changes in the configuration of 
the network. Subarea nodes can provide gateway func- 
tion, and boundary function support for peripheral 
nodes. Type 4 and type 5 nodes are subarea nodes. 
See boundary node, host node, node, peripheral node, 
and subarea host node. See also boundary function 
and node type. 


subarea path control. The function in a subarea node 
that routes message units between network address- 
able units (NAUs) and provides the paths between 
them. See path contro! and peripheral path control. 
See also beundary function, peripheral node, and 
Subarea node. 


subarea PU. In SNA, a physical unit (PU) in a subarea 
node. 


subarea routing function. In SNA, a path control capa- 
bility in a subarea node that receives and routes path 
information units (PiUs) that originate in or are destined 
for units in the subarea. See also boundary function. 


suboperand. One of multiple elements in a list com- 
prising an operand. See also definition statement. 


subsystem. A secondary or subordinate system, 
usually capable of operating independent of, or asyn- 
chronously with, a controlling system. 


supervisor. The part of a control program that coordi- 
nates the use of resources and maintains the flow of 
processing unit operations. 


supervisor cali (SVC). A request that serves as the 
interface into operating system functions, such as allo- 
cating storage. The SVC protects the operating system 
from inappropriate user entry. All operating system 
requests must be handled by SVCs. 


supervisor call (SVC) instruction. An instruction that 
interrupts the program being executed and passes 
control to the supervisor so that it can perform a spe- 
cific service indicated by the instruction. 


suppression character. In the NetView program, a 
user-defined character that is coded at the beginning of 
a command list statement or a command to prevent the 
statement or command from appearing on the opera- 
tor’s terminal screen or in the network log. 


SVC. (1) Supervisor call. (2) Switched virtual circuit. 
SWINN. Switched intermediate network node. 


switched intermediate network node (SWINN). Depre- 
cated term for intermediate routing node. 


switched line. A communication line in which the con- 
nection between the communication controller and a 
remote link station is established by dialing. 


switched major node. In VTAM, a major node whose 
minor nodes are physical units and logical units 
attached by switched SDLC links. 


switched network backup (SNBU). An optional facility 
that allows a user to specify, for certain types of PUs, a 
switched line to be used as an alternate path if the 
primary line becomes unavailable or unusable. 
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switched virtual circuit (SVC). An X.25 circuit that is 
dynamically established when needed. The X.25 equiv- 
alent of a switched line. 


symptom string. A structured character stripg written 
to a file when VTAM detects certain error conditions. 


SYNAD exit routine. A synchronous EXLST exit routine 
that is entered when a physical error is detected. 


Synchronous Data Link Control (SDLC). A discipline for 
managing synchronous, code-transparent, serial-by-bit 
information transfer over a link connection. Trans- 
mission exchanges may be duplex or half-duplex over 
switched or nonswitched links. The configuration of the 
link connection may be point-to-point, multipoint, or 
loop. SDLC conforms to subsets of the Advanced Data 
Communication Contro!l Procedures (ADCCP) of the 
American National Standards Institute and High-Level 
Data Link Control (HDLC) of the International Standards 
Organization. 


synchronous 1/0. In VTAM, when the system services 
control point (SSCP) sends a request and suspends 
processing for that request until the response is 
received. A variable work area remains allocated 
while the SSCP waits for the response. When the 
response is received, the suspended process resumes 
at the next sequential instruction. 


synchronous operation. In VTAM, a communication, or 
other operation in which VTAM, after receiving the 
request for the operation, does not return control to the 
program until the operation is completed. Contrast 
with asynchronous operation. 


synchronous request. In VTAM, a request for a syn- 
chronous operation. Contrast with asynchronous 
request. 


system management facility (SMF). A standard feature 
of MVS that collects and records a variety of system 
and job-related information. 


System Modification Program (SMP). An operating 
system component that facilitates the process of 
installing and servicing an MVS system. See also 
System Modification Program Extended. 


System Modification Program Extended (SMP/E). An 
IBM licensed program that facilitates the process of 
installing and servicing an MVS system. See also 
System Modification Program. 


system monitor. The portion of the configuration image 
in a 3601 Finance Communication Controller that 
handles communications with control operators and 
records error statistics and other operational data. 


system services control point (SSCP). In SNA, a central 


location point within an SNA network for managing the 
configuration, coordinating network operator and 
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problem determination requests, and providing direc- 
tory support and other session services for end users 
of the network. Multiple SSCPs, cooperating as peers, 
can divide the network into domains of control, with 
each SSCP having a hierarchical control relationship to 
the physical units and logical units within its domain. 


system services control point (SSCP) domain. The 
system services control point and the physical units 
(PUs), logical units (LUs), links, link stations and all the 
resources that the SSCP has the ability to control by 
means of activation requests and deactivation 
requests. 


Systems Network Architecture (SNA). The description 
of the logical structure, formats, protocols, and opera- 
tional sequences for transmitting information units 
through and controlling the configuration and operation 
of networks. 


system record. Information that the NetView/PC 
program uses to identify itself to a network. 


System Support Programs (SSP). An IBM licensed 
program, made up of a collection of utilities and small 
programs, that supports the operation of the NCP. 


TAF. Terminal access facility. 


tailing. A feature on a multi-channel modem that 
allows another modem link to be attached to one of the 
channels. See multi-tailed and twin-tailed. See also 
fanout. 


takeover. The process by which the failing active sub- 
system is released from its extended recovery facility 
(XRF) sessions with terminal users and replaced by an 
alternate subsystem. See resource takeover. 


TAP. Trace analysis program. Synonymous with 
ACFITAP. 


task. A basic unit of work to be accomplished by a 
computer. The task is usually specified to a control 
program in a multiprogramming or multiprocessing 
environment. 


task panel. Online display from which you communi- 
cate with the program in order to accomplish the pro- 
gram’s function, either by selecting an option provided 
on the panel or by entering an explicit command. See 
help panel. | 


TC. Transmission control. 


TCAM. (1) Telecommunications Access Method. Syn- 
onymous with ACF/TCAM. (2) The IBM licensed 
program whose full name is Advanced Communi- 
cations Function for TCAM and that provides queued 
message handling. TCAM Versions 1 and 2 are access 
methods, but TCAM Version 3 is a message handling 
subsystem. 


TCAS. Terminal control address space. 
TCU. Transmission control unit. 


telecommunication line. Any physical medium such as 
a wire or microwave beam, that is used to transmit 
data. Synonymous with transmission line. 


teletypewriter exchange service (TWX). Teletypewriter 
service in which suitably arranged teletypewriter 
stations are provided with lines to a central office for 
access to other such stations throughout the U.S. and 
Canada. Both baudot and ASClli-coded machines are 
used. Business machines may also be used with 
certain restrictions. 


temporary error. A resource failure that can be 
resolved by error recovery programs. Synonymous 
with performance error. Contrast with permanent 
error. 


terminal. A device that is capable of sending and 
receiving information over a link; it is usually equipped 
with a keyboard and some kind of display, such as a 
screen or a printer. 


terminal access facility (TAF). !n the NetView program, 
a facility that allows a network operator to control a 
number of subsystems. In a full-screen or operator 
control session, operators can control any combination 
of such subsystems simultaneously. 


terminal control address space (TCAS). The part of 
TSO/VTAM that provides logon services for TSO/VTAM 
users. 


terminal component. An addressable part of a terminal 
that performs an input or output function, such as the 
display component of a keyboard-display device ora 
printer component of a keyboard-printer device. 


TERMINATE. In SNA, a request unit that is sent by a 
logical unit (LU) to its system services control point 
(SSCP) to cause the SSCP to start a procedure to end 
one or more designated LU-LU sessions. 


TG. Transmission group. 
TGID. Transmission group identifier. 
TH. Transmission header. 


threshold. In the NetView program, refers to a per- 
centage value set for a resource and compared to a 
calculated error-to-traffic ratio. 


threshold analysis and remote access. (1) A compo- 
nent of NetView that can notify a central operator about 
network problems and errors. It provides remote 
control of IBM 3600 and 4700 controllers and can 
record, analyze, and display performance and status 
data on IBM 3600 and 4700 Finance Communications 


Systems. (2) The feature of the back-level NPDA 
licensed program that performs some of these func- 
tions. 


TIC. Token-ring interface coupler. 


time sharing option (TSO). An optional configuration of 
the operating system that provides conversational time 
sharing from remote stations. 


timeout recovery. Restarting system operations after 
they have been interrupted by failure of a certain event 
to occur. 


time sharing option for VTAM (TSO/VTAM). An optional 
configuration of the operating system that provides 
conversational time sharing from remote stations in a 
network using VTAM. 


token. A sequence of bits passed from one device to 
another along the token ring. When the token has data 
appended to it, it becomes a frame. 


token ring. A network with a ring topology that passes 
tokens from one attaching device to another. For 
example, the IBM Token-Ring Network. 


token-ring interface coupler (TIC). An adapter that can 
connect a 3725 Communication Controller to an IBM 
Token-Ring Network. 


trace analysis program (TAP). An SSP program 
service aid that assists in analyzing trace data 
produced by VTAM, TCAM, and NCP and provides 
network data traffic and network error reports. 


transaction program. (1) A program that is executed 
by or within an application program and performs ser- 
vices related to the processing of a transaction. (2) In 
VTAM, a program that performs services related to the 
processing of a transaction. One or more transaction 
programs may operate within a VTAM application 
program that is using the VTAM application program 
interface (API). In that situation, the transaction 
program would request services from the application 
program, using protocols defined by that application 
program. The application program, in turn, could 
request services from VTAM by issuing the APPCCMD 
macroinstruction. 


transmission control character. Any control character 
used to control or facilitate transmission of data 
between data terminal equipment. Synonymous with 
communication control character. 


transmission control (TC) layer. In SNA, the layer 
within a half-session that synchronizes and paces 
session-level data traffic, checks session sequence 
numbers of requests, and enciphers and deciphers 
end-user data. Transmission control has two compo- 
nents: the connection point manager and session 
control. See also half-session. 
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transmission control unit (TCU). A communication 
control unit whose operations are controlled solely by 
programmed instructions from the computing system to 
which the unit is attached; no program is stored or exe- 
cuted in the unit. Examples are the IBM 2702-and 2703 
Transmission Controls. Contrast with communication 
controller. 


transmission group (TG). In SNA, a group of links 
between adjacent subarea nodes, appearing as a 
single logical link for routing of messages. A trans- 
mission group may consist of one or more SDLC links 
(parallel links) or of a single System/370 channel. 


transmission group identifier (TGID). In SNA, a set of 
three values, unique for each transmission group, con- 
sisting of the subarea addresses of the two adjacent 
nodes connected by the transmission group, and the 
transmission group number (1-255). 


transmission header (TH). In SNA, control information, 
optionally followed by a basic information unit (BIU) or 
a BIU segment, that is created and used by path control 
to route message units and to control their flow within 
the network. See also path information unit. 


transmission line. Synonym for telecommunication 
line. 


transmission priority. In SNA, a rank assigned to a 
path information unit (PIU) that determines its preced- 
ence for being selected by the transmission group 
contro! component of path control for forwarding to the 
next subarea node of the route used by the PIU. 


transmission services (TS) profile. In SNA, a specifica- 
tion in a session activation request (and optionally, in 
the responses) of transmission control (TC) protocols 
(such as session-level pacing and the usage of session- 
level requests) to be supported by a particular session. 
Each defined transmission services profile is identified 
by a number. | 


transmission subsystem component (TSC). The compo- 
nent of VTAM that comprises the transmission control, 
path control, and data link control layers of SNA. 
transparent mode. A mode of binary synchronous com- 
munication (BSC) text transmission in which data are 
transmitted only as specific bit patterns. 

TSC. Transmission subsystem component. 

TSO. Time sharing option. 

TSO/VTAM. Time sharing option for VTAM. 


tutorial. Online information presented in a teaching 
format. 
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twin-tailed. In NCP, when a communication controller 
is attached to two host processors. See multi-tailed. 
See also fanout and tailing. 


TWX. Teletypewriter exchange service. 


type 2.1 node (T2.1 node). A node that can attach to an 
SNA network as a peripheral node using the same pro- 
tocols as type 2.0 nodes. Type 2.1 nodes can be 
directly attached to one another using peer-to-peer pro- 
tocols. See end node, node, and subarea node. See 
also node type. 


type 2.1 node (T2.1 node) control point domain. The 
CP, its logical units (LUs), links, link stations, and all 
resources that it activates and deactivates. 


UNBIND. In SNA, a request to deactivate a session 
between two logical units (LUs). See also session 
deactivation request. Contrast with BIND. 


unformatted. In VTAM, pertaining to commands (such 
as LOGON or LOGOFF) entered by an end user and 
sent by a logical unit in character form. The character- 
coded command must be in the syntax defined in the 
user’s unformatted system services definition table. 
Synonymous with character-coded. Contrast with field- 
formatted. 


unformatted system services (USS). In SNA products, a 
system services control point (SSCP) facility that trans- 
lates a character-coded request, such as a logon or 
logoff request into a field-formatted request for proc- 
essing by formatted system services and translates 
field-formatted replies and responses into character- 
coded requests for processing by a logical unit. Con- 
trast with formatted system services. See also 
converted command. 


uninterpreted name. In SNA, a character string that a 
system services control point (SSCP) is able to convert 
into the network name of a logical unit (LU). Typically, 
an uninterpreted name is used in a logon or Initiate 
request from a secondary logical unit (SLU) to identify 
the primary logical unit (PLU) with which the session is 
requested. 


unit of display. A body of information that must be dis- 
played as a single unit. The exact format of the display 
is left to the discretion of the focal-point product. 


unsolicited message. A message, from VIAM to a 
program operator, that is unrelated to any command 
entered by the program operator. Contrast with solic- 
ited message. 


upstream. In the direction of data flow from the end 
user to the host. Contrast with downstream. 


upstream device. For the IBM 3710 Network Controller, 
a device located in a network such that the device is 
positioned between the 3710 and a host. A communi- 


cation controller upstream from the 3710 is an example 
of an upstream device. Contrast with downstream 
device. 


upstream line. For the IBM 3710 Network Controller, a 
telecommunication line attaching a 3710 to an 
upstream device. Contrast with downstream line. 


user. Anyone who requires the services of a com- 
puting system. 


user-application network. A configuration of data proc- 
essing products, such as processors, controllers, and 
terminals, established and operated by users for the 
purpose of data processing or information exchange, 
which may use services offered by communication 
common Carriers or telecommunication Adminis- 
trations. Contrast with public network. 


user application record. In the NetView/PC program, 
defines the communication path between the 
NetView/PC program and the device it is communi- 
cating with. 


user correlator. A 4-byte value supplied to VTAM by an 
application program when certain macroinstructions 
(such as REQSESS) are issued. It is returned to the 
application program when subsequent events occur 
(such as entry to a SCIP exit routine upon receipt of 
BIND) that result from the procedure started by the ori- 
ginal macroinstruction. 


user exit. A point in an IBM-supplied program at which 
-a user routine may be given control. 


user exit queue. A structure built by VTAM that is used 
to serialize the execution of application program exit 
routines. Only one exit routine on each user exit queue 
can run at a time. 


USERVAR. Contains an application name used to route 
a session-establishment request to the currently active 
application subsystem. | 


user-written generation application. A user-written 
program that runs with the NCP/EP definition facility 
(NDF) during NCP generation. It processes definition 
statements and operands. 


using node. (1) In NCP, the NCP in the host’s domain 
that reports a link error condition. (2) For the 
command facility of NetView and for NCCF, the ID 
parameter of certain network control commands. 


USS. Unformatted system services. 


value. (1) (TC97) A specific occurrence of an attribute, 
for example, “blue” for the attribute “color.” (2) A 
quantity assigned to a constant, a variable, a param- 
eter, or a symbol. 


variable. In the NetView program, a character string 
beginning with & that is coded in a command list and is 
assigned a value during execution of the command list. 


verb. (1) In SNA, the general name for a transaction 
program’s request for communication services. (2) In 
VTAM, a programming language element in the logical 
unit (LU) 6.2 application program interface (API) that 
causes an LU 6.2 function to be performed. 


viewing filter. In the NetView program, the function that 
allows a user to select the data to be displayed ona 
terminal. All other stored data is blocked. 


virtual disk. (1) A logical subdivision (or all) of a phys- 
ical disk pack in the VM operating system that has its 
own virtual device address, consecutive virtual cylin- 
ders, and a volume table of contents (VTOC) or disk 
label identifier. (2) Synonymous with minidisk. 


virtual machine. A functional simulation of a computer 
and its associated devices. 


Virtual Machine (VM). A licensed program whose full 
name is the Virtual Machine/System Product (VM/SP). 
It is a software operating system that manages the 
resources of a real processor to provide virtual 
machines to end users. As a time-sharing system 
control program, it consists of the virtual machine 
control program (CP), the conversational monitor 
system (CMS), the group control system (GCS), and the 
interactive problem control system (IPCS). 


virtual machine group. One or more virtual machines 
that have been loaded in the same group control 
system (GCS). 


virtual route (VR). In SNA, a logical connection (1) 
between two subarea nodes that is physically realized 
as a particular explicit route, or (2) that is contained 
wholly within a subarea node for intranode sessions. A 
virtual route between distinct subarea nodes imposes a 
transmission priority on the underlying explicit route, 
provides flow control through virtual-route pacing, and 
provides data integrity through sequence numbering of 
path information units (PIUs). See also explicit route 
(ER), path, and route extension. 


virtual route identifier (VRID). In SNA, a virtual route 
number and a transmission priority number that, when 
combined with the subarea addresses for the subareas 
at each end of a route, identify the virtual route. 


virtual route (VR) pacing. In SNA, a flow control tech- 
nique used by the virtual route control component of 
path control at each end of a virtual route to control the 
rate at which path information units (PIUs) flow over the 
virtual route. VR pacing can be adjusted according to 
traffic congestion in any of the nodes along the route. 
See also pacing and session-level pacing. 
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virtual route pacing response (VRPRS). A non- 
sequenced, supervisory path information unit (PIU) that 
flows at network priority. It may overtake 
VR-sequenced PIUs and consists of a transmission 
header with no basic information unit (BIU) data. 


virtual route selection exit routine. In VTAM, an 
optional installation exit routine that modifies the list of 
virtual routes associated with a particular class of 
service before a route is selected for a requested 
LU-LU session. 


virtual route sequence number. In SNA, a sequential 
identifier assigned by the virtual route control compo- 
nent of path control to each path information unit (PIU) 
that flows over a virtual route. It is stored in the trans- 
mission header of the PIU. Contrast with session 
sequence number. 


virtual storage. (ISO) The notion of storage space that 
may be regarded as addressable main storage by the 
user of a computer system in which virtual addresses 
are mapped into real addresses. The size of virtual 
storage is limited by the addressing scheme of the 
computer system and by the amount of auxiliary 
storage available, not by the actual number of main 
storage locations. 


Virtual Storage Access Method (VSAM). An access 
method for direct or sequential processing of fixed and 
variable-length records on direct access devices. The 
records in a VSAM data set or file can be organized in 
logical sequence by a key field (key sequence), in the 
physical sequence in which they are written on the data 
set or file (entry-sequence), or by relative-record 
number. 


Virtual Storage Extended (VSE). An IBM licensed 
program whose full name is the Virtual Storage 
Extended/Advanced Function. It is a software oper- 
ating system controlling the execution of programs. 


Virtual Storage Extended/Operator Communication 
Control Facility (VSE/OCCF). A facility that intercepts 
messages from the VSE supervisor. NCCF and 
VSE/OCCF help an NCCF operator contro! multiple VSE 
systems from a central site. 


Virtual Telecommunications Access Method (VTAM). 
An IBM licensed program that controls communication 
and the flow of data in an SNA network. It provides 
single-domain, multiple-domain, and interconnected 
network capability. 


Virtual Telecommunications Access Method Entry 
(VTAME). A licensed program that provides single- 
domain and multiple-domain network capability for 
4300 systems using VSE. . 


VIT. VTAM internal trace. 
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VM. Virtual Machine operating system. Its full name is 
Virtual Machine/System Product. Synonymous with 
VM/SP. 


VM SNA console support (VSCS). A VTAM component 
for the VM environment that provides Systems Network 
Architecture (SNA) support. It allows SNA terminals to 


be virtual machine consoles. 


VM/SP. Virtual Machine/System Product operating 
system. Synonym for VM. 


VM/VCNA. VM/VTAM Communications Network Appli- 
cation. 


VM/VTAM Communications Network Application 
(VM/VCNA). An IBM licensed program that provides 
SNA support for VM. It allows SNA terminals to be 
used as virtual machine consoles. See also VM SNA 
console support. 


VR. Virtual route. 

VRID. Virtual route identifier. 

VRPRS. Virtual route pacing response. 
VSAM. Virtual Storage Access Method. 
VSCS. VM SNA console support. 


VSE. Virtual Storage Extended operating system. Syn- 
onymous with VSE/AF. 


VSE/AF. Virtual Storage Extended/Advanced Function 
operating system. Synonym for VSE. 


VSE/OCCF. Virtual Storage Extended/Operator Com- 
munication Control Facility. 


VTAM. Virtual Telecommunications Access Method 
(IBM licensed program). Its full name is Advanced 
Communications Function for the Virtual Telecommuni- 
cations Access Method. Synonymous with ACF/VTAM. 


VTAM application program. A program that has 
opened an ACB to identify itself to VTAM and can now 
issue VTAM macroinstructions. 


VTAM definition. The process of defining the user 
application network to VTAM and modifying 
1BM-defined characteristics to suit the needs of the 
user. 


VTAM definition library. The operating system files or 
data sets that contain the definition statements and 
start options filed during VTAM definition. 


VTAME. Virtual Telecommunications Access Method 
Entry. Synonymous with ACF/VTAME. 


VTAM internal trace (VIT). A trace used in VTAM to 
collect data on channel I/O, use of locks, and storage 
management services. 


VTAM operator. A person or program authorized to 
issue VTAM operator commands. See domain oper- 
ator, program operator, and network operator (2). 


VTAM operator command. A command used to monitor 
or control a VTAM domain. See also definition state- 
ment. 


VTAM Terminal I/O Coordinator (VTIOC). The part of 
TSO/VTAM that converts TSO TGET, TPUT, TPG, and 
terminal control macroinstructions into SNA request 
units. 


VTIOC. VTAM Terminal !/O Coordinator. 


V.25 bis. Procedure defined by CCITT which describes 
the sequence of events involved in establishing a con- 
nection between a serial automatic calling data station 
and an automatic answering data station on the 
General Switched Telephone Network (GSTN) using the 
100 series interchange circuits. This procedure is 
known as serial automatic calling. 


well-behaved application program. (1) An application 
program that runs without disruption to the network. 
(2) An application program that runs in the Disk Oper- 
ating System (DOS) partition without disrupting 
NetView/PC functions. 


wide area network. A network that provides data com- 
munication capability in geographic areas larger than 
those serviced by local area networks. Wide area net- 
works may extend across public rights-of-way. Con- 
trast with local area network. 


window. (1) In SNA, synonym for pacing group. (2) On 
a visual display terminal, a small amount of information 
in a framed-in area on a panel that overlays part of the 
panel. 


window size. In SNA, synonym for pacing group size. 


wrap. In general, to go from the maximum to the 
minimum in computer storage. For example, the con- 


tinuation of an operation from the maximum value in 
storage to the first minimal value. 


wrap count. In the NetView program, the number of 
events that can be retained on the data base for a spe- 
cific resource. 


XID. Exchange identification. 
XRF. Extended recovery facility. 
X.21. See Recommendation X.21 (Geneva 1980). 


X.21 communication adapter. An IBM 3710 Network 
Controller communication adapter that can combine 
and send information on one line at speeds up to 64 
kbps, and conforms to CCITT X.21 standards. See also 
Recommendation X.21 (Geneva 1980). 


X.25. See Recommendation X.25 (Geneva 1980). 


X.25 NCP Packet Switching Interface (NPSI). The X.25 
Network Control Program Packet Switching Interface, 
which is an IBM licensed program that allows SNA 
users to communicate over packet-switched data net- 
works that have interfaces complying with Recommen- 
dation X.25 (Geneva 1980) of the International 
Telegraph and Telephone Consultative Committee 
(CCITT). It allows SNA programs to communicate with 
SNA equipment or with non-SNA equipment over such 
networks. In addition, this product may be used to 
attach native X.25 equipment to SNA host systems 
without a packet network. See also Recommendation 
X.25 (Geneva 1980). 


ZAP disk. The virtual disk in the VM operating system 
that contains the user-written modifications to VTAM 
code. See BASE disk, DELTA disk, MERGE disk, and 
RUN disk. 


2-wire. A type of coupler that has two wires attached to 
it. These two wires connect to one telephone line. 


4-wire. A type of coupler that has four wires attached 
to it. These four wires connect to two telephone lines. 


31-bit storage addressing. The storage address struc- 
ture available in an MVS/XA operating system. 
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Index 


Special Characters 


? command, description 5-2, 6-52 


AAUTSKLP tasks 7-5, 8-5 
accounting and resource statistics 8-4, 9-30 
accounting data 
network accounting and availability measurement 
data 7-4 
ACQ CLIST 
description 2-2, 3-3 
example 3-3 
syntax 3-3 
ACT CLIST 
description 2-3, 3-5 
example 3-6 
syntax 3-5 
ACTCDRM (activate cross-domain resource 
manager) 7-3 
ACTION CLIST 
description 6-3 
example 1-20, 6-3 
syntax 6-3 
activation 
parameters 7-3 
resources 2-3, 3-5 
status 7-2, 10-2 
active log 
Status monitor 11-1 
active status 
application programs 2-1 
cross-domain resource major nodes 2-2, 3-45 
cross-domain resource manager major nodes 2-2, 
3-44 
ACTLU (activate logical unit) 7-3 
ACTPU (activate physical unit) 7-3 
adding nodes with the status monitor 11-1 
AGAIN CLIST 
description 2-1 
AGAIN command 
description 3-7 
syntax 3-7 
AINQ command 
description 2-1, 3-8 
example 3-9 


syntax 3-8 
alert 
data 4-3 


displaying 5-4 

dynamic display 4-9 
eveni tracking 4-3 
hardware monitor 4-2, 4-3 
history display 4-9 


alert (continued) 
Static display 4-9 
status monitor 11-1, 11-3 
using 5-4 
ALERTSD command, description 5-4, 6-4 
ALERTSH command, description 5-4, 6-5 
aliasname 8-4 
alias name translation table 
altering information 2-12, 3-17 
retrieving information 2-12, 3-8 
all (PF12), status monitor 11-3 
all controllers, selection 4-12 
ALLC command 
description 5-6, 6-54 
syntax 6-54 
application program 
active status 2-1, 3-11 
displaying status 2-1, 3-10 
pending state 2-1, 3-12 
APPLS CLIST 
description 2-1, 3-10 
example 3-10 
syntax 3-10 
APPLSACT CLIST 
description 2-1, 3-11 
example 3-11 
syntax 3-11 
APPLSPEN CLIST 
description 2-1, 3-12 
syntax 3-12 
APPLSPEN command 
example 3-12 
ASSIGN command 
description 2-5, 3-13 
example 3-14 
syntax 3-13 
AT command 
description 2-7, 3-15 
example 3-15 
syntax 3-15 
ATTN key 1-15 
AUPD command 
description 2-3, 
example 3-18 
syntax 3-17 
AUTOCOLL CLIST 
description 8-3, 9-3 
example 9-3 
syntax 9-3 
automated 
CLISTS 2-7, 2-13 
commands 2-7 
routing 2-10 


Index 
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automatic reactivation bottom (scrolling directly to end) (continued) 


starting 11-1, 12-8 status monitor 11-2 
stopping 11-1, 12-7 using PF5— 1-15, 4-12 
AUTOMSG command BOTTOM command 
description 2-5, 2-7, 3-20 description 6-7, 9-6 
example 3-21 example 9-6 
syntax 3-20 session monitor 8-1 
AUTORECD CLIST syntax 6-7, 9-6 
description 9-4 boundary function trace data 7-3 
example 9-4 BROWSE CLIST 
syntax 9-4 description 3-33 
AUTOTASK command DSICLD data set 3-33 
description 2-7, 2-13, 3-23 DSIPARM data set 3-33 
syntax 3-23 DSIVTAM dataset 3-33 
AUTOTR command example 3-35 
description 2-3, 3-24 syntax 3-33 
syntax 3-24 browse facility 
autowrap description 1-1 
indicator 1-11 task 
unlocking the screen’ 1-13 starting 3-158 
AUTOWRAP command stopping 3-165 
description 2-1, 3-25 browsing 
example 3-25 network log 10-7, 11-1 
syntax 3-25 PF keys F-1 
status monitor 10-7 
buffer 
B errors 7-1 
BACK command trace 2-3, 3-74 
description 6-6, 9-5 use in VTAM_ 2-1, 3-27 
example 9-5 
MVS and VSE 
description 6-55 C 
syntax 6-55 cable test 2-4, 3-150 
session monitor 8-1 CANCEL command 
syntax 6-6, 9-5 description 3-38 
backward scrolling detaching main task 1-4 
hardware monitor 4-13 stopping CLISTs 2-14 
session monitor /7-11 syntax 3-38 
status monitor 10-7, 11-2 CANCMD command 
using PF7 1-16, 4-13 description 2-4, 2-7, 3-39 
BFRUSE CLIST syntax 3-39 
description 2-1, 3-27 CCPDR command 
syntax 3-27 description 3-40 
BFSESS CLIST syntax 3-40 
description 3-28 CCPLOADF command 
example 3-28 description 3-41 
syntax 3-28 syntax 3-41 
BGNSESS command CCPLOADI! command 
description 2-11, 3-29 description 3-42 
example 3-31 syntax 3-42 
syntax 3-29 CCPLOADT command 
BNJDSERV task 6-45 description 3-43 
BOSESS CLIST syntax 3-43 
description 2-11, 3-32 CDRMS CLIST 
example 3-32 description 2-2, 3-44 
syntax 3-32 example 3-44 
bottom (scrolling directly to end) syntax 3-44 


session monitor 7-11 
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CDRSCS CLIST 
description 2-2, 3-45 
example 3-45 
syntax 3-45 
CHANGEFP command 
description 3-46 
syntax 3-46 
channel links, status 2-2 
CICS (Customer Information Control System) 
accessing 2-11 
class of service 
changing definitions in alias translation table 2-3, 
3-17 
determining names 2-1, 3-8 
CLEAR command 
description 3-48 
syntax 3-48 
clear key 1-9, 1-15 
CLIST (command list) 
automation 3-20 
browsing contents 2-13, 3-33, 3-99 
commands in status monitor 10-4 
commands to use in conjunction with 2-13 
continue processing 2-14, 3-78 
definitions, where defined 3-33 
entering hardware monitor commands 4-7 
full-screen mode 4-7 
help information 1-19 
pause 2-13 
reinstate processing 2-14, 3-179 
status monitor 10-7 
stop processing 2-14, 3-38 
suspend processing 2-14, 3-155 
WAIT 2-14 
where defined 3-33 
CLOSE command 
description 3-49 
example 1-5, 3-49 
from system console’ 1-4 
syntax 3-49 
CLRSTATS command, description 11-4, 12-3 
CLSTRS CLIST 
description 2-2, 3-51 
example 3-51 
syntax 3-51 
cluster controller 
See 3174 
CMDMDL statement 1-14 
CNMPNL1, browsing 3-33 
COLLECT command 
description 8-4, 9-7 
example 9-7 
syntax 9-7 
collecting 
solicited data 4-1 
unsolicited data 4-1 
color 
status monitor 10-2 


color (continued) 
terminal 1-14 

command 
alerts 5-4 
authorization 1-7, 3-99 
automatic routing 2-10 
backward 4-13 
bottom 4-12 
changing status of resources 2-2 
communicating with multiple NetView 
programs 2-10 
connecting to VITAM applications 2-11 
controlling logging 5-5 
copying 4-13 
cross-domain viewing 8-4 
data services task (DST) 2-9 
description 6-58 
displaying PF keys 4-13 
displaying status of network resources 2-1 
ending 2-12, 2-13, 3-105, 4-12 
ending processing 3-140 
entering 4-7 
entry line 4-7 
error recovery 2-13 
error-to-traffic 5-5 


event 5-4 
explicit 4-7 
filters 5-3 


forward 4-13 

from system console’ 1-4 
hardware monitor 5-1, 6-24 
hardware monitor control unit 5-4 
hardware monitor finance system 5-5 
HELP 5-1 

help information 1-17, 1-19 

HELP NPDA 5-1 

HELP TARA 5-1 

immediate 1-3 

inCLISTs 2-13 

lists (CLISTs) 4-7 

messages 2-5 

NetView 2-1 

network control 2-2 

network log 2-6 

network product support 2-4 
operator-related resources 2-5 
optional task 2-9 

recording 2-6 

recording filters 5-3 

reguiar 1-3 — 

repeating 2-1, 3-7 

restricting use 1-7 

retrieving 3-142, 4-13, 8-2 

rules 1-11 

scheduling during intervals 2-8, 3-71 
scheduling for a specific time of day 2-7 
scope 1-7 

screen control 2-1 
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command (continued) 
security 1-6 
selection 4-12 
SESS 7-6 
session awareness data 8-2 
session data 8-4 
session monitor 8-1 
session trace data 8-3 
specific resource 5-4 
Statistics 5-3 
Status monitor 10-4, 11-1 
summary A-1 
suppression 1-14 
TARA 5-5 
TEST command 5-5 
timer 2-7 


tracing NetView processing 2-12, 3-174 


3710 network controller 2-4 

586X modem 2-4 
command area 

changing size 2-1 

commands 4-7 

retrieving last command 2-1, 3-142 

screen 1-14 

selection numbers 4-7 

setting size 2-1, 3-89 

status monitor 10-5 
COMMAND command 

description 6-8, 6-56 
command facility 


command summary A-1 - 


description 1-1 

entering 6-23 

full-screen mode 12-9 

PF keys F-1 

routing commands to 9-23 

screen control 2-1 

screen layout 1-10 
command interface area 

Status monitor 10-4 
command list (CLIST) 

command 4-9 

displaying 4-9 
command lists 

See CLISTs 
communication adapter test 2-4, 3-150 
communication facilities, test 6-48 
components 

configuration 4-4 
configuration 

components 4-4 

modem, 586X 2-5, 3-111 

3710 2-4, 3-61 
connectivity information 2-2, 3-58 
contact | 

close 2-5, 3-114 

open 2-5, 3-114 
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contents, NCP 2-2 
control commands display, selection 4-11 
control records, recording 5-3 
controller 
See 3710 
controller commands 5-5 
controller summary, selection 4-12 
COPY command 
description 6-9, 9-8 
example 9-8 
MVS and VSE 
description 6-57 
syntax 6-57 
session monitor 8-1 
syntax 6-9, 9-8 
using PF9 4-13 
counter values 
temporary errors 4-9 
CPU (host processor) 4-4 
cross-domain : 
link stations 2-2, 3-160 
NetView, status of 2-10, 3-99 
network manager, deactivating 2-13, 3-162 
session 
displaying status 3-99 
sending commands) 2-10, 3-145 
Starting 2-10, 3-156 
stopping 2-10, 3-162 
trace data 8-4 
session monitor data collection 7-1 
status of resource major nodes 2-2, 3-45 
terminals, buffer trace for 2-3, 3-24 
cross-domain resource manager 
status of major nodes 2-2, 3-44 
CTRL command 
description 6-10, 6-58 
example 6-10, 6-58 
link test counts. 4-10 
release level information 4-10 
summary error counts 4-10 
syntax 6-10, 6-58 
current ratio status, displaying 5-5, 6-15 
cursor 1-9 


D 


DASD Conservation Option 1-17, 2-8 
data 
collection 
communications network management 
(CNM) 4-1 
hardware monitor 4-1 
solicited data 4-1 
supervisor call instruction 4-1 
SVC 76 4-1 
unsolicited data 4-1 
requesting 3600 or 4700. 5-7, 6-70 
summary display 5-6, 6-10, 6-73 


data services task (DST) 
definitions, location of 3-33 
listing 2-9, 3-99 
network log 2-9 
purging 2-9, 3-131 
Starting 2-9, 3-156 
stopping 2-9, 3-162 
date and time 
event information 5-4, 6-18 
information 5-4 
MRECENT information 6-22 
Statistical information 5-3, 6-13 
DATE CLIST, description 3-52 
~ DDOMAIN command 
description 5-4, 6-11 
example 6-11 
response 6-11 
syntax 6-11 
deactivating a resource 2-3, 3-85, 3-86 
DEFAULTS command 
description 2-7, 3-53 
syntax 3-53 
definition statements 
session monitor, reloading 8-5, 9-31 
where defined 3-33 
DELAY CLIST 
description 2-8, 3-54 
example 3-54 
syntax 3-54 
DELAY2 CLIST 
description 2-8, 3-55 
example 3-55 
syntax 3-55 
delimiters, locating 12-10 
detail, event 4-9 
detailed information area on status monitor 10-4 
DFILTER command 
description 5-3, 6-12 
example 6-12 
syntax 6-12 
dial station 2-5, 3-114 
dial-out path information 2-2, 3-127 
DIS CLIST 
description 3-56, 6-13 
example 3-56 
syntax 3-56, 6-13 
DISABLE command 
description 8-2, 9-9 
example 9-9 
syntax 9-9 
DISCONID command 
description 2-9, 3-57 
syntax 3-57 
_ disconnecting from a full-screen session 2-11 
disconnection key 2-11 
DISG command 
description 2-2, 3-58 
example 3-58 


DISG command (continued) 
syntax 3-58 
DISKEEP command 
description 8-3, 9-10 
example 9-10 
syntax 9-10 
DISPCMD command 
description 2-4, 2-7, 3-60 
example 3-60 
syntax 3-60 
DISPCNFG command 
description 2-4, 3-61 
example 3-61 
syntax 3-61 
DISPFK CLIST 
description 3-62 
example 3-62 
session monitor 7-11 
syntax 3-62 
display 
prompt 4-10 
TEST command 4-10 
title 4-6 
DISPLAY command 
description 5-6, 6-59 
example 6-60 
syntax 6-59 
use of 2-4 
displaying . 
CTRL command 4-10 
help 4-10 
prompt 4-10 
domain 
changes data retrieved 5-5, 6-35 
higher node 10-1 
identification 
display 5-5, 6-11 
displaying 5-4 
lower node 10-1 
name 
COMC 4-6 
CPU 4-6 
CTRL 4-6 
DEV 4-6 
DPPX 4-6 
hardware monitor 4-6 
LINE 4-6 
MVS . 4-6 
NCP 4-6 
PU 4-6 
RESNAME 4-6 
TYPE 4-6 
VTAM 4-6 
session 4-9 
session information 8-2, 9-20 
session status 7-10 
Domain Status Detail panel 10-6 
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Domain Status Summary panel 10-6 
double byte characters (DBCS) 
network log 3-33 
DRATIO command 
description 5-5, 6-15 
example 6-15 
syntax 6-15 
DRDS CLIST 
description 2-3, 3-64 
syntax 3-64 
DROUTE CLIST 
description 3-65 
example 3-66 
syntax 3-65 
DROUTE command 
description 2-2 
DSICLD data set, browsing 2-14, 3-33 
DSIPARM data set 
browsing 2-14, 3-33 
reloading definition statements 8-5 
DSIPRF data set, browsing 2-14 
DSIPRF, browsing 3-33 
DSISAPDR CLIST 
description 2-4, 3-67 
syntax 3-67 
DSIVTAM data set, browsing 2-14 
DSIVTAM, browsing 3-33 
DST 
See data services task 
DST (data services task) 
immediate commands __ 1-3 
regular commands __1-3 
DWRAP command 
description 5-5, 6-16 
END 6-17 
example 6-16 
syntax 6-16 
usage note 6-16 
dynamic display 
alerts 4-9 


E 
ENABLE command 
description 8-2, 9-11 
syntax 9-11 
END command 
description 6-17, 9-12 
example 6-17, 9-12 
MVS and VSE 
description 6-61 
syntax 6-61 
status monitor 10-7 
syntax 6-17, 9-12 
using PF2 1-15, 4-12 
ending commands 2-12 
ENDSESS command 
description 2-11, 3-68 
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ENDSESS command (continued) 
example 3-68 
syntax 3-68 
entering 
command facility 6-23 
commands 4-7 
hardware monitor 6-24 
NetView components’7 1-16 
using enter key 1-15 
4700 Support Facility 6-72 
ER 
See explicit routes 
ERASE EOF key 1-9 
ERASE INPUT key 1-9 
error 
buffer 7-1 
codes, help information 1-17, 1-19 
description, probable cause 4-3 
lost PlUs 7-1 
resource status /7-1 
unresponsive terminal 7-1 
error recovery 
status 2-13 
error-to-traffic (E/T) ratio 
sets 5-4, 6-36 
using 5-5 
ERST CLIST 
description 2-8, 3-69 
example 3-69 
syntax 3-69 
ESESS CLIST 
description 2-11, 3-70 
example 3-70 


syntax 3-7/0 
event 
data 4-3 


displaying 5-4 
hardware monitor 4-1, 4-2 
mostrecent 4-9 
removing 5-4 
total 4-9 
using 5-4 
event or Statistical records 
establishing number 6-46 
event types 
abbreviations 4-3 
codes 4-3 


using in filter-setting commands 4-3 


EVENTS CLIST 
description 5-4, 6-18 
example 6-18 
syntax 6-18 
usage note 6-18 

EVERY command 
description 2-8, 3-71 
example 3-72 
syntax 3-71 


EXCMD command 
description 3-73 
syntax 3-73 
explicit route (ER) 
configuration. 7-10 
information 7-4, 7-9 
listing 7-10 
session information 8-2, 9-20 
status 2-2, 3-65 
VTAM display 2-2 
external log 
accounting and resource statistics 9-30 
controlling 5-5, 6-31 


network accounting and availability measurement 


data 7-4 


« 


feedback codes 
help information 1-19 
fields 
help facility 1-17 
selecting in status monitor 10-5 
filter 
error data 4-1 
hardware monitor 4-1 
recording 5-3 
using 5-2 
viewing 5-3 
FIND command 
description 12-4 
syntax 12-4 
FORCE command 
description 8-3, 9-13 
example 9-14 
syntax 9-13 
FORWARD command 
description 6-19, 9-15 
example 9-15 
MVS and VSE 
description 6-62 
syntax 6-62 
session monitor 8-1 
syntax 6-19, 9-15 
forward scrolling 
session monitor 7-11 
status monitor 10-7, 11-3 
using PF8 1-16, 4-13 
FTRACE CLIST 
description 2-3, 3-74 
example 3-74 
syntax 3-74 
full-screen mode 
AUTOWRAP_ 3-25 
command facility 12-9 
screen layout 1-10 
status monitor 11-1, 12-12 


full-screen session, disconnecting 2-11 


G 


gateway trace data 7-3 

GCS EXEC 1-3 

GENALERT command 
description 3-75 
syntax 3-7/5, 3-76 

global authority 1-6 

GO command 
description 2-14, 3-78 
example 3-78 
syntax 3-78 


hard-copy log, device 1-8 
hardware monitor 
alert 4-2 
Capabilities 4-1 
command summary A-1 
commands _ 5-5, 6-24 
cross-domain commands 5-5 
data 4-1 
description 1-1 
entering 6-24 
event 4-1, 4-2 
filters 4-1 
help information 1-19, 1-20 
Information/Management E-1 
PF keys F-1 
previous screen 5-1 
recording problems E-1 
screen layout 1-10 
solicited data 4-1 
STARTCNM command 4-5 
Starting 4-5, 5-1 
Statistics 4-1, 4-2 
stopping 5-1 
stopping panel sequence’ 6-17 
tasks 
starting 3-158 
stopping 3-165 
threshold 4-2 
unsolicited data 4-1 
using 4-5 
HCF (host command facility), accessing 2-11 
heading definition, displaying 5-2, 6-52 
held messages 1-13 
HELP CLIST 
definition 12-5 
description 2-8, 3-79, 6-20, 9-16 
example 3-80, 6-20 : 
MVS and VSE 
description 6-63 
syntax 6-63 
syntax 3-79, 6-20, 12-5 
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help desk 
description 1-17 
entering 1-20 

help facility 
description 1-1, 1-17 
entering commands 1-17 
PF keys. F-1 

help information 
access to 1-18 
commands 1-17, 5-1 
connecting to other VTAM applications 2-12 
displaying 4-10 
error codes’ 1-17 
index 1-17 
menu 4-10 
online 1-17, 4-13 
problem solving techniques’ 1-17 
session monitor 7-12 
status monitor 10-8, 11-1 
using PF1_ 1-15 
4700 Support Facility 4-13 

HELPDESK CLIST 
description 2-8, 3-81 
example 1-20, 3-81 
syntax 3-81 

HEXDEC CLIST 
description 3-82 
example 3-82 
syntax 3-82 

higher node 10-1 

history display, alerts 4-9, 5-4 

HOLD command 
description 2-1, 3-83 
syntax 3-83 

hold indicator 1-11 

HOLD key 1-13 


immediate command 1-3 
implicit routing 2-10 
IMR CLIST 
description 3-84 
example 3-84 
syntax 3-84 
IMS (Information Management System), 
accessing 2-11 
INACT CLIST 
description 2-3, 3-85 
example 3-85 
syntax 3-85 
INACTF CLIST 
description 2-3, 3-86 
example 3-86 
syntax 3-86 
inactive log, status monitor 11-1 
INDEX CLIST 
description 2-8, 3-87 
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INDEX CLIST (continued) 
example 3-87 
syntax 3-87 
index, online 1-17 
indicators, screen 1-11 
Information/Management E-1 
INIT failure, configuration 7-9 
initial command 1-9 
INPUT command 
description 2-1, 3-89 
example 3-89 
setting size of command area 
syntax 3-89 
lO trace 2-3, 3-74 
JOPD CLIST 
description 3-90 
example 3-90 
syntax 3-90 


K 


Kanji 
network log. 11-2 
KEEP command 
description 8-3, 9-17 
example 9-17 
syntax 9-17 
keep count, displaying 7-10 
keyboard 1-15 
keys 
ATIN 1-15 
CLEAR 1-9, 1-15, 2-11 
disconnection 2-11 
ENTER 1-15 
ERASE EOF 1-9 
ERASE INPUT 1-9 
HOLD 1-13 
PA1 2-11 
PF 1-15, 2-11 


L 


last page, displaying 5-2, 6-7 
layout of panels 4-6 
LCTL (tape or disk controller) 4-4 
LDEV (control unit) 4-4 
LEFT command 
description 9-18 
left, scrolling 
status monitor 11-3 
level of hierarchy of panels 
command entry area 4-6, 4-7 
date andtime 4-6 
display number 4-6 
display title 4-6 
hierarchy information 4-6 
information requested 4-6 
message area 4-6, 4-7 
operating instructions 4-6 


1-14 


level of hierarchy of panels (continued) 
operational information 4-6 
page number 4-6 
requested information 4-6 
significant event 4-6 
Statistical data 4-6 
time and date 4-6 


title 4-6 
light pen 10-5 
line 


backup line 2-4, 3-92 
changing speed 2-4, 2-5, 3-92, 3-114 
secondary link 2-4, 3-92 
Status 2-2, 3-91 
switched 2-3, 3-136 
trace 2-3, 3-74 
line mode 
screen layout 1-10 
LINEMAP command 
description 8-2, 9-19 
example 9-19 
syntax 9-19 
LINES CLIST 
description 2-2, 3-91 
example 3-91 
syntax 3-91 
LINESTAT command 
description 2-4, 3-92 
example 3-92 
syntax 3-92 
link problem determination aid (LPDA) 
changing status 2-4, 2-5, 3-106, 4-9 
querying status 2-4, 2-5, 3-106, 4-9 
LINKDATA command 
description 2-7, 3-93 
syntax 3-93 
LINKPD command 
description 2-7, 3-95 
syntax 3-95 
LINKTEST command 
description 2-7, 3-97 
syntax 3-97 
LIST command 
browsing contents of CLIST 2-13 
commands authorized to use _1-/ 
cross-domain NetView 2-10 
data services task (DST) 2-9 
description 3-99,9-20 | 
example 3-101, 9-21 
network log 2-5, 2-6 
operator 2-10 
operator identification 2-5 
operators authorized to received messages 2-5 
optional tasks 2-9 
profile 2-5 
profile name _ 1-6 
session awareness data 8-2 
span of control 1-6 


LIST command (continued) 
syntax 3-99, 9-20 
tasks 2-5 
terminal status 2-5 
timer requests 2-8 
trace log 2-6 
LISTSESS command 
description 2-11, 3-102 
example 3-102 
syntax 3-102 
LISTVAR CLIST 
description 3-103 
example 3-103 
syntax 3-103 
LL2 CLIST 
description 3-104 
example 3-104 
syntax 3-104 
locating information 
network log 12-4 
log browse facility 11-2 
logging information 
external log 5-5 
logical unit (LU) 
connectivity information 2-2, 3-58 
deleting from alias translation table 2-3, 3-17 
determining names 2-1, 3-8 
session information 8-2, 9-20 
status 2-2, 3-170 
logmode 
changing definitions in alias translation table 2-3, 
3-17 
names, determining 2-1, 3-8 
LOGOFF command 
description 2-13, 3-105 
syntax 3-105 
LOGON command 
example 1-7 
logon information 1-8 
LOOP command 
description 5-6, 6-64 
syntax 6-64 
loop most recent error 
selection 4-12 
4700 Support Facility 6-76 
loop most recent status 
selection 4-12 
4700 Support Facility 6-76 
lower node 10-1 
LPDA (link problem determination aid) 
changing status 2-4, 2-5, 3-106, 4-9 
querying status 2-4, 2-5, 3-106, 4-9 
LPDA command 
description 2-4, 2-5, 3-106 
example 3-107 
syntax 3-106 
LSESS CLIST 
description 2-11, 3-108 
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LSESS CLIST (continued) 
example 3-108 
syntax 3-108 

LU 
See logical units 


M 
MAINMENU CLIST 
description 3-109 
syntax 3-109 
MAJNODES CLIST 
description 2-2, 3-110 
example 3-110 
syntax 3-110 
major node 
connectivity information 2-2, 3-58 
NODE CLIST 2-2, 3-124 
status 2-2, 3-110 
MAX, PF key function 11-2 
MDMCNFG command 
description 2-5, 3-111 
example 3-112 
syntax 3-111 
MDMCNTL command 
description 2-5, 3-114 
example 3-115 
syntax 3-114 
menu 
displaying 
selection 4-9, 4-11 
help 4-10 
MVS and VSE 
displaying 6-65 
panel 
displaying 4-5, 5-2, 5-6, 6-21, 6-65, 7-6 
selection 4-5 
status monitor 10-8 
MENU command 
description 6-21, 9-22 
example 9-22 
MVS and VSE 
description 6-65 
session monitor 8-1 
syntax 9-22 
message area 
data 4-7 
location onscreen. 1-11 
message indicators 
status monitor 11-1 
messages 
associated with alerts 11-2, 11-3 
format 1-12 
held 1-13 
location on screen. 1-11 
NetView active 1-4 
order in NetView 1-11 
origins 1-12 
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messages (continued) 
parsing 12-10 
receiving 2-5, 3-13 
recording 2-6 
replying 1-13 
sending to network log 2-5, 3-117 
sending to operators 2-5, 3-117 
sense code explanations 8-2 
severity 1-14 
status monitor 11-1 
types 1-12 
minor node 
definition statements, where defined 3-33 
NODE CLIST 2-2, 3-124 
mistakes, correcting 1-9 
modem 
testing 6-48 
using modem information 5-5 
modems 
See 586X 
MODIFY command 
use of 2-4 
MONIT command 
description 11-1, 12-6 
example 12-6 
syntax 12-6 | 
monitoring inactive nodes 
status monitor 10-2 
MONOFF CLIST 
automatic reactivation, stopping 12-7 
description 11-1, 12-7 
example 12-7 
syntax 12-7 
MONON CLIST 
description 11-1, 12-8 
example 12-8 
syntax 12-8 
most recent display 
error 5-6 
loop 5-6 
statistics 4-9, 5-6, 6-42 
status 5-6 
MOVE command 
description 2-13, 3-116 
example 3-116 
syntax 3-116 
moving : 
multiple-page 6-20, 6-63 
panel to panel 6-20, 6-63 
4700 Support Facility 6-63 
MRECENT command 
description 5-3, 5-4, 6-22 
example 6-22 
syntax 6-22 
MSG command 
description 2-5, 3-117 
example 93-117 
from system console’ 1-4 


MSG command (continued) 
syntax 3-117 

MVS command 
description 2-10, 3-118 
syntax 3-118 


N 
NCCF 
See command facility 
NCCF command 
description 6-23, 9-23, 12-9 
entered from hardware monitor 6-48 
syntax 6-23, 9-23, 12-9 
NCCF START command 6-35 
NCP (Network Control Program) 
connectivity information 2-2, 3-58 
contents 2-2 
dumping 2-3, 3-119 
line port address 8-2, 9-19 
networks 2-3, 3-122 
reconfiguring 2-3, 3-64 
releasing 2-3, 3-137 
session trace data 8-2 
station threshold value 2-4, 2-5, 3-171 
storage contents 3-121 
trace data 7-3 
NCPDUMP CLIST 
description 2-3, 3-119 
example 3-120 
syntax 3-119 
NCPSTOR CLIST 
description 2-2, 3-121 
example 3-121 
syntax 3-121 
NETSTRT command 1-3 
NetView 
accessing other NetView sessions 2-11 
browsing libraries 3-33 
Capabilities 2-1 
command summary A-1 
commands 
help information 1-19 
commands to use with CLISTs 2-13 
communicating with more than one 2-10 
components 
command facility 1-1 
hardware monitor 1-1 
help information 1-18 
session monitor 1-1 
status monitor 1-1 
connecting to VTAM applications 2-11 
ending 2-13, 3-105 
entering components 1-16 
error code help facility 1-19 
error recovery 1-5, 2-13 
log browse facility 11-2 
menu panel 3-109 


NetView (continued) 


message format 1-12 
message order 1-11 
messages 2-5 

overview 1-1 

PF keys 4-12 

program function key 4-12 
recording commands 2-6 


returning to a previous component 1-15, 4-12 


screen layout 1-10 


sending commands cross-domain 2-10, 3-145 


starting 1-3 
starting cross-domain session 2-10, 3-156 
stopping 1-5 
stopping cross-domain session 2-10, 3-162 
system console operation 1-4 
tasks 
Starting 3-158 
stopping 3-165 
terminal operation 1-7 
trace 2-12, 3-174 
transferring control 1-5 


NetView-NetView task 


See NNT 


network 
accounting and availability measurement 7-4 


defined NCPs 2-3, 3-122 
interconnected 2-12 
log 
browsing 3-33, 11-1 
commands 2-6 
data services task (DST) 2-9 
DBCS information 3-33 
deactivating 2-13, 3-162 
files 11-1 
KANJI information 11-2 
listing information 2-5 
locating information 12-4 
printing 2-6 
repeating FIND commands 12-11 
scrolling 11-3 
sending messages 2-5 
starting 2-6, 3-156 
status 2-6, 3-99 
stopping 2-6, 3-162 
switching 2-6, 2-9, 3-167 
switching automatically 2-6 
messages 2-2 
product support (NPS) 2-4 
routing 1-6 
span of control 1-6 
status 2-1 


NETWORK CLIST 


description 2-3, 3-122 
example 3-122 
syntax 3-122 


NEWS CLIST 


description 3-123 
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NEWS CLIST (continued) 
syntax 3-123 
next page, displaying 6-19, 6-62 
NLDM 
See session monitor 
NLDM command 
description 9-24 
syntax 9-24 
NNT (NetView-NetView task) 1-2, 2-10 
node 
automatic reactivation 11-1, 12-6 
starting automatic reactivation 12-8 
States in status monitor 10-2 
NODE CLIST 
description 2-2, 3-124 
example 3-124 
syntax 3-124 
Node Status Detail panel 10-6 
Node Status Summary panel 10-7 
NOSTAT CLIST 
description 2-3, 3-125 
syntax 3-125 
NOTNSTAT command 
example 3-173 
NPDA 
See hardware monitor 
NPDA command 6-24, 6-33 
NPS (network product support) 2-1 
NTO sessions /7-1 
numbered message 4-3 


O 


online help 
See also help 
hardware monitor 5-1 
information 4-13 
status monitor 10-8, 11-1 
operands 
restricting use 1-7 
operating instructions 
commands 4-7 
displaying 4-6 
prompts 4-7 
operational information 
displaying 4-6 
operational operands 
adjusting 5-6, 6-68 


displaying 
DISPLAY 5-6 
TTERR 5-6 
TTRESP 5-6 
TWERR_ 5-6 
TWRESP_ 5-6 
TWSTAT 5-6 
4700 Support Facility 6-59, 6-74 
operator 


definition 3-33 
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operator (continued) 
error recovery status 2-13 
identification 1-8, 2-5, 2-13 
listing information 2-5 
profile 2-14, 3-33 
receiving messages 2-5, 3-99 
restricting commands _1-7 
span of control 1-6 
station task (OST) 1-2 
system console 1-3 
optional tasks 
listing 2-9, 3-99 
OST (operator station task) 1-2 
OVERRIDE command 
description 2-8, 3-126 
syntax 3-126 


P 
paging 
backward 1-16, 4-13, 11-2 
bottom 1-15 
copying 4-13 
forward 1-16, 4-13 
hardware monitor 5-1 
scrolling directly toend 4-12 
session monitor 8-1 
status monitor 11-2 
top 1-15, 4-12 
panel 
Alerts-Dynamic 4-3, 6-4 
Alerts-History 6-5 
CNMPNL1 3-33 
command 5-1, 5-5 
hardware monitor 4-10 
hierarchy 7-7, 10-5 
layout 4-6, 10-3 
major nodes’ 10-6 
minor nodes_ 10-6 
NetView menu 3-109 
node count 10-6 
paging in multipage panels 
backward 1-16, 4-13 
bottom 1-15, 4-12 
copy 4-13 
forward 1-16, 4-13 
top 1-15, 4-12 
printing acopy 8-1, 9-8 
session monitor 
control commands’ 8-1 
hierarchy 7-7 
layout 7-6 
menu 8-1, 9-22 
status monitor 10-5, 10-6 
TEST 4-10 
PARSE command 
description 12-10 
example 12-10 


PARSE command (continued) 
syntax 12-10 
parsing amessage 12-10 
password 1-8 
path information unit (PIU) 
See PIU 
PATHS CLIST 
description 2-2, 3-127 
example 3-127 
syntax 3-127 
pause 
CLISTs 2-13 
indicator 1-11 
PDFILTER CLIST 
description 6-25 
syntax 6-25 
PENDING CLIST 
description 2-2, 3-128 
example 3-128 
syntax 3-128 
pending state 
application programs 2-1 
application status 3-12 
nodes 2-2, 3-128 
performance class 7-4 
PF keys 
definitions by component F-1 
displaying settings 1-16, 4-13, 8-2 
hardware monitor 4-12 
NetView default definitions 1-15, 4-12 
session monitor 7-11 
setting insession monitor 9-42 
status monitor 10-7, 11-2 
4700 Support Facility 4-12 
PFKDEF CLIST 
description 3-129 
syntax 3-129 
physical components 
how touse 4-4 
levels 4-4 
physical unit (PU) 
connectivity information 2-2, 3-58 
dial-out path information 2-2, 3-127 
releasing 2-3, 3-137 
session information 8-2, 9-20 
status 2-2, 3-51 
PIU (path information unit) 
count 8-3 
data 7-3 
discarded /7-3 
displaying session data 7-3 
lost 7-1 
trace data 8-3, 9-41 
PMX (programmable operator message 
exchange) 1-4 


PPT (primary program operator interface task) 


PRGATT command 
description 5-3, 5-4, 6-26 


PRGATT command (continued) 
example 6-26 
removing 5-4 
syntax 6-26 
primary and secondary files, switching 6-45 
primary program operator interface 
See PPT 
printing logs 
network log 3-130 
trace log 3-130 
PRINTLOG CLIST 
description 3-130 
example 3-130 
syntax 3-130 
probable cause 
error description 4-3 
problem determination 
recording problems in the hardware monitor 
profile 
defining 1-8 
displaying 1-6, 3-99 
listing information 1-8, 2-5 
restricting commands 1-7 
program function keys 10-7 
programmable operator message exchange 
See PMX 
protocol violation 7-3 
PU (physical unit) 2-2 
PURGE command 
data services task (DST) 2-9 
description 3-131, 5-4, 6-27, 8-3, 9-25 
example 3-131, 6-28 
syntax 3-131, 6-27, 9-25 
timer requests 2-8 
PURGEDB command 
description 5-3, 5-4, 6-29, 8-3, 9-27 
syntax 6-29, 9-27 


Arsh 


QHCL CLIST 
description 3-133 
syntax 3-133 

QUERY PF command 
description 8-2, 9-28 
example 9-28 
syntax 9-28 

QUERY RANGE command 
description 9-29 
example 9-29 
syntax 9-29 
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REPORTS command 
description 5-5, 6-31 
syntax 6-31 
REQMS command 
description 5-3, 6-32 
request/response unit (RU) 7-3 
RESET command 
description 2-12, 3-140 
syntax 3-140 


description 2-8, 3-134 
example 1-19, 3-134 
syntax 3-134 
reason codes 7-3 
recommended action 
actions 4-9 
description 6-3 


displaying 4-9 Pes Oee: ae 
recommended action codes, help information 1-20 chs a 
RECORD command activating 2-3, 3-5 
active 10-2 


description 8-4, 9-30 

example 9-30 

syntax 9-30 
recording data 5-4, 6-38 
recording filters 

displaying 5-3 
records 


automatic reactivation 11-1, 12-6 
availability information 7-4 
changing implicit routing 2-10 
deactivating 2-3, 3-85 
deactivating then activating 2-3, 3-135 
displaying status 2-1 
controlling 5-3, 6-43 distribution 8-4 
displaying 5-5, 6-16 force deactivating 2-3, 3-86 
RECYCLE CLIST | identifying associated spans 1-6, 3-99 
description 2-3, 3-135 inactive 10-2 
example 3-135 monitoring 10-2 
syntax 3-135 never activated 10-2 
REDIAL CLIST pending 10-2 
description 2-3, 3-136 session awareness data 8-2, 9-20 
example 3-136. session information 7-9 
syntax 3-136 Starting 1-6, 3-156 


REFRESH command gens 10-2 - 
status monitor 10-7 sae pe : - 
regular command 1-3 race data o- 


REL CLIST 7 tracing 7-3 | 
description 2-3, 3-137 usage information 7-4 
example 3-137 VTAM control 2-2, 3-3 
syntax 3-137 within span of control 1-6, 3-99 


RELCONID command ia States aa 
description 2-10, 3-138 Status monitor 10- 
syntax 3-138 response area 1-13 

RELOAD command response time data 
description 8-5, 9-31 collecting 8-3, 8-4, 9-7 
example 9-31 | description 7-4, 7-9, 8-3 
syntax 9-31 graphs 9-34, 9-36 

removing nodes time range 9-29, 9-43 
status monitor 11-1 seeaue start - 

REPEAT command Sones 
description 12-11 description 6-33, 6-66 
syntax 12-11 RETRIEVE command 


repeating FIND command description 3-142, 8-2 
status monitor 11-3 syntax 3-1 42 
REPLY command retrieving, using PF12 1-16, 4-13 
description 3-139 return | 
example 1-4, 1-5, 3-139 status monitor 10-7 
from system console 1-4 using PF3 1-15, 4-12 


syntax 3-139 r se : eohes | ae 
reply messages 1-13 a ee or iar 
reply number 1-4 comman 


description 3-143, 6-34, 9-32 
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RETURN command (continued) 

MVS and VSE 
description 6-67 

session monitor 8-1 
syntax 3-143, 9-32 

RH (request/response header) 7-3 

RIGHT command 
description 9-33 
status monitor 12-4 

roll 
status monitor 10-7 
using PF6 1-16, 4-13 

ROLL command 
description 3-144 
example 3-144 
syntax 3-144 

ROUTE command 
description 2-10, 3-145 
example 3-145 
syntax 3-145 

routing data 7-4 

RSESS CLIST 
description 2-11, 3-146 
example 3-146 
syntax 3-146 

RTM (response time monitor) 
feature 7-4 

RTREND command 
description 9-34 
example 9-35 
graphs 8-4 
syntax 9-34 

RTRNSESS command 
description 2-11, 3-147 
syntax 3-147 

RTSUM command 
description 8-4, 9-36 
example 9-36 
syntax 9-36 

RU (request/response unit} 7-3 

RUNCMD command 
description 2-7, 3-149 
syntax 3-149 

RUNDIAG command 
description 2-4, 3-150 
syntax 3-150 


S 


scheduling 

commands 2-7, 3-15 

for a specific time of day 3-15 
scope of commands 

description 1-6 

setting up 1-7 
screen 

broken line 1-11 

command area 1-14 


screen (continued) 


indicators 1-11 
layout 1-10 
message area. 1-11 
response area 1-13 
scrolling 2-1, 3-25 
session identification line 1-11 
setting up 2-1 
unlocking 2-1, 3-83 
scrolling 11-2 
SDOMAIN command 
description 6-35, 9-38 
example 6-35, 9-38 
response 6-35 
syntax 6-35, 9-38 


security 
measures’ 1-6 
SENDSESS command 


description 2-11, 3-151 
syntax 3-151 
sense code 
explanation 7-10 
help information 1-19 
SENSE command 
description 8-2, 9-39 
example 1-19, 9-39 
syntax 9-39 
service adapter password, changing 2-4, 3-67 
service modem test 2-4, 3-150 
SESS command 
description 8-2, 9-40 
example 9-40 
session monitor 7-6 
syntax 9-40 
session 
activation parameters 7-3, 9-41 
configuration 7-9 
data 7-2 
domain 4-9 
_ identification line 1-11 
information 7-9 
parameters 7-9 
partners 7-2 
path 8-4 
response time 7-9 
termination 7-9 
session awareness data 
description 7-2 
displaying 8-2 
forms 7-3 
listing sessions 8-2, 9-40 
starting data collection 8-2, 9-11 
stopping data collection 8-2, 9-9 
warm start 7-5 
session monitor 
accessing /-5 
accounting and resource Statistics 8-4 
capabilities 8-1 
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session monitor (continued) 
command entry area 7-6 
command help 1-19, 8-1 
command summary A-1 
cross-domain viewing 8-4 
data collected /7-1 
data sources /7-1 
description 1-1, 7-1 
displaying data /7-1 
entering commands /7-6 
help for 7-10, 7-12 
menu 7-6 
message area /7-6 
network accounting and availability measurement 
data /-4 
panel 
control 8-1 
hierarchy (7-7 
layout 7-6 
PF keys F-1 
PF keys, setting 9-42 
response time data (7-4, 8-3 
routing data /7-4 
rules for entering 7-6 
screen layout 1-10 
session awareness data 7-2, 8-2 
session trace data 7-3, 8-2 
Starting 7-4, 8-1 
tasks 
Starting 3-158 
stopping 3-165 
warm start 7-5 
session trace data 
counts 8-3, 9-10 
cross-domain 8-4 
description 7-3 
PiU count 8-3, 9-17 
resources being traced 8-3, 9-46 
session count 8-3, 9-17 
Starting 8-3, 9-46 
stopping 8-3, 9-46 
to disk 8-3, 9-13 
virtual storage 8-3, 9-17 
warm start 7-5 
SET command 
description 3-152, 5-6, 6-68 
example 3-153, 6-69 
syntax 3-152 
SET HEX command 
description 8-3, 9-41 
syntax 9-41 
SET PF command 
description 9-42 
example 9-42 
syntax 9-42 
SET RANGE command 
description 8-4, 9-43 
example 9-43 
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SET RANGE command (continued) 
syntax 9-43 
SETCGLOB CLIST 
description 3-154 
syntax 3-154 
significant event 
data 4-6 
Statistical data 4-6 
SMF (system management facility) 
accounting and resource statistics 9-30 
recording accounting and resource statistics 
SNA (Systems Network Architecture) 
architecture sessions /7-1 
commands /7-3 
session information 7-1 
SOLICIT command 
description 5-7, 6-70 
solicited data 
collecting 4-1 
data 4-1 
hardware monitor 4-1 
span list 1-6 
span of control 
deleting 1-6, 3-162 
description 1-6 
global authority 1-6 
listing resources’ 1-6, 3-99 
overlapping 1-6 
starting resources’ 1-6, 3-156 
stopping resources’ 1-6, 3-162 
valid commands _ 1-6 
SRATIO command 
description 5-4, 6-36 
example 6-37 
syntax 6-36 
SRFILTER command 
description 5-4, 6-38 
example 6-41 
syntax 6-38 
SSCP (system services control point) 
acquiring resources 3-3 
session information 8-2, 9-20 
STACK command 
description 2-14, 3-155 
example 3-155 
syntax 3-155 
START command 
cross-domain session 2-10 
data services task (DST) 2-9 
description 3-156 
example 3-157 
MVS 1-3 
network log 2-6 
re-establishing terminal session 2-13 
span list 1-6 
span of control 1-6 
syntax 3-156 
trace log 2-6 


8-4 


STARTCNM CLIST 
description 3-158 
example 3-158 
hardware monitor 5-1 
session. monitor 8-1 
syntax 3-158 
STARTDOM CLIST 
description 3-159 
syntax 3-159 
starting 
automatic reactivation 11-1, 12-8 
hardware monitor 4-5 
NetView 1-3 
Static display 
alerts 4-9 
station threshold value 2-5, 3-171 
STATIONS CLIST 
description 2-2, 3-160 
example 3-160 
syntax 3-160 
statistical 
data 4-6 
detail 4-9 
display 6-51 
displaying 4-9 
event 4-6 
significant event 4-6 
statistics 
data 4-3 
hardware monitor 4-1, 4-2 
node status analysis 11-4, 12-3 
recording 2-3, 3-125, 3-173 
using 5-3 
STATMON 
See status monitor 
STATMON command 
description 11-1, 12-12 
syntax 12-12 
STATS CLIST 
description 5-3, 6-42 
example 6-42 
syntax 6-42 
status 
application programs 2-1, 3-10 
channel links 2-2, 3-91 
cross-domain 
link stations 2-2, 3-160 
NetView session 2-10, 3-99 
resource major nodes 2-2, 3-45 
resource manager major nodes 2-2, 3-44 
error recovery 2-13 
explicit routes 2-2, 3-65 
lines 2-2, 3-91 
LU device types 2-2, 3-170 
major nodes 2-2, 3-110 
pending nodes 2-2, 3-128 
physical units 2-2, 3-51 
requesting 3600 or 4700 5-7, 6-70 


status (continued) 
summary display 5-6, 6-10, 6-73 
timer request 2-8, 3-99 
virtual routes 2-2, 3-65 
WAIT 2-14 
STATUS CLIST 
description 2-8, 3-161 
example 3-161 
help information 1-20 
syntax 3-161 
status codes, help information 1-20 
status modifier 
help information 1-20 
status monitor 
accessing 11-1, 12-12 
active log 11-1 
alerts 11-2, 11-3 
browsing network log 10-7, 11-1 
capabilities 10-1, 11-1 
collecting information 10-1 
color usage 10-2 
command 
capabilities 11-1 
formats and operands 12-1 
help information 1-19 
command summary A-1 
description 1-1 
entering commands 10-4, 10-5 
full-screen mode 11-1, 12-12 
general information 10-1, 10-4 
hierarchy 10-1 
higher node 10-1 
inactive log 11-1 
lower node 10-1 
major nodes’ 10-1 
message indicators 11-1 
messages 11-1 
minor nodes’ 10-1 
monitoring inactive nodes 10-2 
online help 10-8, 11-1 
panel 10-6 
detail 10-3 
hierarchy 10-5 
layout 10-3 
summary 10-3 
types 10-3 
parsing 12-10 
PF keys 10-7, 11-2, F-1 
resetting statistics 11-4, 12-3 
resource states 10-2 
restarting resources 10-1 
screen layout 1-10 
scrolling network log. 11-2 
summarizing information 10-1 
tasks 
starting 3-158 
stopping 3-165 
terminology 10-1 


index 


X-67 


status monitor (continued) 
using 10-3 
STOP command 
‘cross-domain session 2-10 
data services task (DST) 2-9 
deactivating 
cross-domain network manager 2-13 
network log 2-13 
trace log 2-13 
description 3-162 
network log 2-6 
span list 1-6 
span of control 1-6 
syntax 3-162 
task 2-13 
terminal session 2-13 
trace log 2-6 
STOPCNM CLIST 
description 3-165 
example 3-166 
syntax 3-165 


stopping 
automatic reactivation 11-1, 12-7 
NetView 1-5 

stops 


4700 Support Facility 6-61 
storage contents, NCP 3-121 
subsystem 

displaying connected sessions 3-102, 3-108 

ending asession 3-68, 3-70 

returning to a disconnected session 3-146, 3-147 

sending commands) 3-151 

sending messages 3-151 

Starting sessions 3-29, 3-32 
summary error counters 

requests 5-3, 6-32 
suppression character 1-14 
SVFILTER command 

description 5-3, 6-43 

example 6-44 

syntax 6-43 
SWITCH command 

description 2-9, 3-167 

example 3-168 

syntax 3-167 
switched lines, dialing 2-3, 3-136 
switching 

primary and secondary files 6-45 
SWLD command 

description 9-44 

example 9-44 

session monitor file 8-5 

syntax 9-44 
SWLOG command 

description 3-169 

example 3-169 

syntax 3-169 
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SWPD CLIST 
description 6-45 
example 6-45 
syntax 6-45 

SWRAP command 
description 6-46 
example 6-47 
response 6-47 
syntax 6-46 

SYSMON command 
description 5-7, 6-71 

system console 
entering NetView commands __ 1-4 
operation 1-3 

system monitor 
accessing 5-7, 6-71 

system operator 1-3 


7 


TAF (terminal access facility) 
logmodes- 3-31 

TARA command 
description 6-72 

TARA LOOP command 
example 6-64 

TARA SET command 
syntax 6-68 

tasks 
AAUTSKLP 7-5, 8-5 
description 1-2 
DST (data services task) 1-3 
listing information 2-5 
NNT (NetView-NetView task) 1-2 
OST (operator station task) 1-2 
PPT (primary program operator interface task) 1-2 
Starting 3-158 
stopping 3-162, 3-165 

TCTRL CLIST 
description 5-6, 6-73 
example 6-73 

temporary errors 4-2 

terminal 
buffer trace for cross-domain session 2-3, 3-24 
color 1-14 : 
correcting mistakes 1-9 
error recovery status 2-13 
failure 7-1 
highlighting 1-14 
keyboard 1-15 
monochrome 1-14 
non-SNA data collection 7-1 
operation 1-7 
operator-control session 2-11 
re-establishing session 2-13, 3-156 
recording activity 2-6 
response time 8-3 
shifting work 2-13, 3-116 


terminal (continued) 
SNA data collection 7-1 
status 2-5 
stopping asession 2-13, 3-162 
unresponsive 7-1 
terminal access facility 
connecting to VTAM applications 2-11 
ENDSESS command 3-68 
logmodes_ 3-31 
terminology 
hardware monitor 4-4 
physical components 4-4 
status monitor 10-1 
system configuration 4-4 
TERMS CLIST 
description 2-2, 3-170 
example 3-170 
syntax 3-170 
TERR CLIST 
description 5-6, 6-74 
example 6-74 
TEST command 
description 5-5, 6-48 
example 6-49 
syntax 6-48 
tests 
attached device status 4-9 
cable 2-4, 3-150 
communication adapter 2-4, 3-150 
communication facilities 6-48 
modem 6-48 
modem status 4-9 
quality 4-9 
service modem 2-4, 3-150 
THRESH command 
description 2-5, 3-171 
example 3-172 
syntax 3-171 
threshold 
data 4-3 
hardware monitor 4-2 
time zone 
considerations 9-7 
timer request 
cancelling 3-55, 3-131 
scheduling 2-7, 3-15 
status 2-8, 3-99 
TNSTAT CLIST 
description 2-3, 3-173 
syntax 3-173 
TOP command 
description 6-50, 9-45 
example 9-45 
MVS and VSE 
description 6-75 
syntax 6-75 
session monitor 7-11, 8-1 
status monitor 11-2 


TOP command (continued) 
syntax 6-50, 9-45 
using PF4 1-15, 4-12 

TOTAL command 
description - 5-3, 5-4, 6-51 
example 6-51 
syntax 6-51 
usage note 6-51 

total events display 4-9 

total statistics 
data 4-9 
displaying 4-9 
Statistics 4-9 

trace 
buffer 2-3 
lO 2-3 
line 2-3 
transmission group 2-3 
VTAM 2-3 

TRACE command 
description 3-174, 9-46 
example 9-47 
NetView processing 2-12 
syntax 3-174, 9-46 

trace log 
printing 2-6 
starting 2-6 
Status 2-6 
stopping 2-6 
switching 2-6 

traces 
buffer 3-74 
buffer, for cross-domain terminals 2-3, 3-24 
lO 3-74 
line 3-74 
NetView processing 2-12, 3-174 
session 7-3, 7-9 
transmission group 3-74 
VTAM_ 3-74 

transmission group 
information 7-4 
listing 7-10 
trace 2-3, 3-74 

transmission header 7-3 

TRANSMSG command 
description 3-176 
syntax 3-176 

TSO (time sharing option) 
accessing 2-11 

TSOUSER CLIST 
description 3-177 
example 3-177 
syntax 3-177 

TSTAT CLIST 
description 5-6, 6-76 
example 6-76 

TTERR CLIST 
description 5-6, 6-77 
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TTERR CLIST (continued) VTAM (continued) 


example 6-77 commands in span of control 1-6 
TTRESP CLIST | commands in status monitor 10-4 
description 5-6, 6-78 controlling of resources 2-2, 3-3 
example 6-78 | discarded PiUs 7-3 
TUTOR CLIST DISPLAY command 
description 2-8, 3-178 description 2-2 
example 3-178 feedback codes 1-19 
syntax 3-178 message reply 1-5 
TWERR CLIST minor node definition statements, where 
description 5-6, 6-79 defined 3-33 
example 6-79 parsing messages’ 12-10 
TWKSTA CLIST recording commands 2-6 
description 6-80 resources 10-1 
example 6-80 restricting commands’ 1-7 
TWRESP CLIST restricting operands’ 1-7 
description 5-6, 6-81 return codes’ 1-19 
example 6-81 sense codes 1-19’ 
TWSTAT CLIST SENSE command 1-19 
description 5-6, 6-82 session trace data 8-2 
example 6-82 status codes’ 1-20 
STATUS command 1-20 
U status modifier 1-20 
trace 2-3, 3-74 
unsolicited data tuning statistics 2-3, 3-173 
collecting 4-1 VTAM applications 
data 4-1 accessing 2-11 
hardware monitor 4-1 ending asession 2-11 
UNSTACK command | help 2-12 
description 2-14, 3-179 sending commands 2-11 
example 3-179 sending messages 2-11 
syntax 3-179 VTAMLST command 
UPDCGLOB CLIST adding or deleting nodes 11-1, 12-6 
description 3-180 member, browsing 2-14 
syntax 3-180 
using PF2 
END command 10-7 ui 
wait 
CLIST 2-14 
V indicator 1-11 
VARY command warm start 7-5 
use of 2-4 WHO CLIST 
viewing filters description 3-182 
defining 5-3, 6-25 syntax 3-182 
displaying 5-3, 6-12 WKSTA command 
virtual route description 5-7, 6-83 
information 7-4 example 6-83 
listing 7-10. syntax 6-83 
session information 8-2, 9-20 workstation most recent response time 
status 3-65, 7-10 display 5-7 
VR selection 4-12 
See virtual routes 4700 Support Facility 6-80, 6-83 
VRST CLIST WRAP CLIST 
description 2-9, 3-181 description 3-183 
example 3-181 syntax 3-183 
syntax 3-181 
VTAM 


acquiring resources 3-3 
buffer use 2-1, 3-27 
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response time data 8-3, 8-4 
using to collect response time data 8-3, 9-7 
3600 or 4700 controllers 
summary display 5-6, 6-54 
3710 network controller 
cable test 2-4, 3-150 
cancelling commands 2-4, 3-39 
changing service adapter password 2-4, 3-67 
commands 2-4 
communication adapter test 2-4, 3-150 
displaying configuration 2-4, 3-61 
line control 2-4, 3-92 
listing outstanding commands 2-4 
LPDA (link problem determination aid) status 2-4, 
3-106 
online diagnostics 2-4, 3-150 
service modem test 2-4, 3-150 
station threshold value 2-4, 3-171 
4700 support facility (TARA) 
all controllers display 4-12 
command selection display 4-12 
control commands display 4-11 
controller summary display 4-12 
entering 6-72 
foop most recent error display 4-12 
loop most recent status display 4-12 
menu display 4-11 
moving within 6-63 
panels 4-10 
PF keys 4-12 
starting 3-158 
stopping 3-165 
stops 5-5, 6-61 
workstation most recent response time 
display 4-12 
586X modem 
cancelling commands 2-4, 3-39 
changing line speed 2-5, 3-114 
closing contact 2-5, 3-114 
commands 2-4 
detecting current of sensor 2-5, 3-114 
dialing station 2-5, 3-114 
disconnecting station 2-5, 3-114 
listing outstanding commands 2-5 
LPDA (link problem determination aid) status 3-106 
modem configuration 2-5, 3-111 
opening contact 2-5, 3-114 
station threshold value 2-5, 3-171 
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